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The following Licensed Program Specification applies 
only to the United States and Puerto Rico. 
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Statement of Limited Warranty 

TopView is warranted to conform to this Licensed 
Program Specification when properly used in its 
designated hardware and software environment. Any 
other documentation with respect to this licensed 
program, excluding any documentation referenced in 
this program specification, is provided for information 
purposes only and does not extend or modify this 
TopView Licensed Program Specification. The 
TopView Licensed Program Specification may be 
updated from time to time. Such updates may constitute 
a change to these specifications. 

This limited warranty and the 90-day program media 
warranty are contained in the IBM Program License 
Agreement supplied with this product and is available to 
all licensees of TopView. This limited warranty is 
extended for 90 days from the initial date of license of 
the software from an IBM authorized reseller, an IBM 
Product Center, or an IBM marketing representative. 



Statement of Function Warranted 



IBM warrants that: 

• The media of the software disks and the TopView 
User's Guide are not defective; 

• The program is properly recorded on the media; 

• The TopView User's Guide is substantially 
complete and correct and contains all the 
information which IBM deems is necessary for use 
of the software; 

• The program functions substantially as described in 
the TopView User's Guide. 

Statement of Operating Environment 

TopView is designed to operate in the following 
environment: 

• Hardware 

• IBM Personal Computer, IBM Personal 
Computer XT, IBM Portable Personal 
Computer, IBM Personal Computer AT 

• 256KB to 640KB of random access memory 

• Two double-sided, double-density IBM diskette 
drives or one double-sided, double-density IBM 
diskette drive and one IBM fixed disk drive 

• IBM Monochrome Display with IBM 
Monochrome Display and Printer Adapter 



. IBM Color Display with IBM Color/Graphics 
Monitor Adapter 

. IBM 80 CPS Matrix Printer 

• IBM Graphics Printer 
. IBM Color Printer 

• Microsoft® Mouse for IBM Personal Computers 
(model number 037-99) 1 or Microsoft® Mouse 
for IBM Personal Computers (model number 
039-99) or PC Mouse™ by Mouse Systems, 
Inc. (part number 900120-214)2 0 r Visi On™ 
Mouse (part number 69910-101 1)3 

• Software 

. IBM PC DOS Version 2.00 or IBM PC DOS 
Version 2.10 or IBM PC DOS Version 3.00 
(Only DOS 2.00 and DOS 2.10 functions are 
available when using DOS 3.00.) 

• IBM logo-ed applications that have been tested 
with TopView by IBM and are in the published 
booklet of compatible applications. Limitations 
or special operating instructions for a particular 
application are noted in this booklet. Ask your 
IBM authorized reseller, the IBM Product 
Center, or an IBM marketing representative for 
a list of these compatible applications. Other 
applications may also work with TopView but 
use of these applications is not warranted. 



1 Microsoft and the Microsoft logo are registered trademarks of 
Microsoft Corporation. 

^PC Mouse is a trademark of Metagraphics/Mouse Systems. 

^Visi On is a trademark of VisiCorp. 



TopView is designed to operate in the following 
environment on an IBM 3270 Personal Computer: 

• Hardware 

• IBM 3270 Personal Computer - Models 4 
and 6 

• 448KB to 640KB of random access memory 

• Two double-sided, double-density IBM diskette 
drives or one double-sided, double-density IBM 
diskette drive and one IBM fixed disk drive 

. IBM 3270 PC Color Display with IBM 3270 
PC Color Display Adapter 

• IBM Monochrome Display with IBM 
Monochrome Display and Printer Adapter 

. IBM 3270 PC APA Adapter for graphics 
applications. 

• IBM Graphics Printer 

• IBM 5182 Color Printer 

• Software 

• IBM 3270 Personal Computer Control Program 
Version 1.2 



IBM PC DOS Version 2.10 



Statement of Service 



Topview software support service is available to 
registered users of TopView. To register, complete and 
mail the enclosed TopView Registration Card. IBM will 
advise each registered user of the software support 
services that are available. Some services are free to all 
registered users and some services are offered to 
registered users for a fee. 



TbpView 



Productivity Family 



Personal 

Computer 

Software 



First Edition (November, 1984) 



The following paragraph does not apply to the United Kingdom or any country where such 
provisions are inconsistent with local law: International Business Machines Corporation 
provides this publication subject to the terms and conditions of the IBM Program License 
Agreement copy contained herein. 

Changes are periodically made to the information herein; these changes will be 
incorporated in new editions of the publication. IBM may make improvements and/or 
changes in the product(s) and/or the program(s) described in this publication at any time. 

It is possible that this publication may contain reference to, or information about, IBM 
products (machines and programs), programming, or services that are not announced in 
your country. Such references or information must not be construed to mean that IBM 
intends to announce such IBM products, programming, or services in your country. 

Products are not stocked at the address below. Requests for copies of this publication and 
for technical information about IBM Personal Computer products should be made to your 
authorized IBM Personal Computer dealer, IBM Product Center, or your IBM Marketing 
Representative. 

The following paragraph applies only to the United States and Puerto Rico: A Reader's 
Comment Form is provided at the back of this publication. If the form has been removed, 
address comments to: IBM Corporation, Personal Computer, P.O. Box 1328-C, Boca 
Raton, Florida 33432. IBM may use or distribute any of the information you supply in 
any way it believes appropriate without incurring any obligations whatever. 

© Copyright International Business Machines Corporation 1984 



Preface 



Top View is an extension to the IBM Personal 
Computer Disk Operating System (DOS) that allows 
you to run several programs at the same time and view 
screens from more than one program on your display. 
Many programs that run under DOS will also run under 
Top View. 

The purpose of this book is to teach you how to use the 
Top View system with your programs. 

You should have experience using the IBM Personal 
Computer, and be familiar with DOS and the programs 
you plan to use before using Top View. 
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The Top View Package 

When you purchase Top View, you receive: 
TopView User's Guide (this book) 
Top View Program diskette 
TopView Tutorial diskette 
TopView Quick Reference 
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Hardware 



Top View operates in the following environment: 

• An IBM Personal Computer, an IBM Personal 
Computer XT, an IBM Portable PC, or an IBM 
Personal Computer AT with at least two 
double-sided, double-density diskette drives or one 
double-sided, double-density diskette drive and a 
fixed disk. 

• A minimum of 256KB of random access memory. 
This minimum memory configuration leaves 
approximately 80KB of memory for use by 
application programs when using DOS 2.00 or 
2.10, or 68KB of memory when using DOS 3.00 or 
3.10. 

Since one of the primary purposes of Top View is 
to save time and give quick access to your 
programs, you will find that you can work more 
efficiently if Top View and all your programs are 
stored in one location. For this reason, we 
recommend a fixed disk and 512KB or more of 
random access memory. 

• One of the following: 

- An IBM Monochrome display with the IBM 
Monochrome Display and Parallel Printer 
Adapter 

- An IBM compatible 80-column color or black 
and white display with the IBM 

Color/ Graphics Monitor Adapter. 

- An IBM Enhanced Color Display with an IBM 
Enhanced Graphics Adapter that is configured 
for Enhanced Color (in Normal Color mode). 
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• A mouse is recommended, but is not required. The 
mice supported as of the date of this publication 
are: 

- Microsoft® Mouse for IBM Personal 
Computers, model number 037-099 (parallel 
interface) 1 

- Microsoft® Mouse for IBM Personal 
Computers, model number 039-099 (serial 
interface) 

- PC Mouse™ by Mouse Systems, part number 
900120-214 (serial interface) 2 

- Visi On™ Mouse, part number 69910-101 1 
(serial interface) 3 

Other pointing devices may be available for use 
with Top View. However, IBM cannot be 
responsible for the selection or use of non-IBM 
products, including mice, and IBM makes no 
warranty of any kind with respect to the use or 
suitability of such products. 

Other pointing devices can be used if a device 
driver exists or is written for the device according 
to the guidelines in the Top View Programmer's 
ToolKit. 

For details on the availability of pointing devices in 
countries other than the United States or Puerto 
Rico, please consult your supplier. 

• A parallel printer is optional. 



Microsoft and the Microsoft logo are registered trademarks of 
Microsoft Corporation. 

PC Mouse is a trademark of Metagraphics/Mouse Systems. 
Visi On is a trademark of VisiCorp. 



Top View operates in the following environment on an 
IBM 3270 Personal Computer: 

• IBM 3270 Personal Computer, Model 4 or Model 
6, with two double-sided, double-density IBM 
diskette drives or one double-sided, double-density 
IBM diskette drive and one IBM fixed disk drive 

• A minimum of 448KB of random access memory 

• IBM 3270 Personal Computer Color Display with 
IBM 3270 Personal Computer Color Display 
Adapter or an IBM Monochrome Display with IBM 
Monochrome Display and Printer Adapter 

• The 3270 Personal Computer APA Adapter is 
required to run graphics applications 

• Top View runs from the Personal Computer session 
of the IBM 3270 Personal Computer Control 
Program Version 1.2 and DOS 2.10 

• A mouse may be used, but is not required. 
Supported mice are listed on the previous page 

• IBM Graphics Printer or an IBM 5 1 82 Color 
Printer 
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Additional Books and Programs 



In addition to the Top View package, you need these 
items: 

• The IBM Personal Computer Guide to Operations 
to be sure that your computer is set up and running 
properly. 

• The IBM Personal Computer Disk Operating 
System (DOS), version 2.00, 2.10, 3.00, or 3.10 
for making a backup copy of your TopView 
diskettes and for use when starting and running 
TopView. 

• The manuals that came with the programs you plan 
to use with TopView (and backup copies of the 
programs). 

• The instructions for attaching a mouse to a 
computer, if you are using a mouse. 

• Two blank, double-sided, double-density diskettes 
and two diskette labels for backing up your 
TopView program and Tutorial diskettes. 

Several blank formatted diskettes to save data 
files on. 
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How to Use This Book 



This book is designed to help you understand the 
TopView program, how it works, and how to get 
started. 

Start by reading Chapters 1 and 2 of this book. Make a 
backup copy of the TopView program and the Tutorial 
diskettes, go through the Setup procedure, and start the 
Tutorial. After you finish the Tutorial, read Chapter 3 
for additional information on the TopView program. 
Chapter 4 gets you started using TopView with your 
programs. 

This book is organized as follows: 

Chapter 1 gives an overview of the TopView program 
and Tutorial. 

Chapter 2 gives a description of the Tutorial, how to 
start it, and how to set up your pointing device. 

Chapter 3 explains the keys that TopView uses and the 
operations available in TopView. This chapter can be 
used as a reference, along with the Tutorial, to 
understand the TopView program and its functions. 

Chapter 4 details the steps needed to add and start your 
programs. It also gives the necessary steps to add 
programs to TopView using two programs provided with 
TopView as an example. 

Chapter 5 describes how to use DOS Services and the 
Color Change Program. 

Chapter 6 tells you how to change the information 
TopView has about your programs. 
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Appendix A contains error messages you might receive 
while using Top View. 

Appendix B contains helpful tips about using Top View. 

Appendix C contains instructions on making a backup 
copy of Top View and on installing Top View on a fixed 
disk. 



Note: The terms disk, diskette, and fixed disk are 
used throughout this book. Where diskette is used, 
it applies only to diskette drives or diskettes. 
Where fixed disk is used, it applies only to the IBM 
nonremovable fixed disk drive. Where disk is used, 
it applies to both fixed disks and diskettes. 
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The Top View Advantage 



TopView is going to make using your IBM Personal 
Computer easier, more efficient, and time saving. 

Picture a desk with piles of papers and notes. You 
could sort through each pile of paper to find 
information, or you could use TopView. 




TopView and your IBM PC make finding and 
processing information easier. And a lot neater too! 
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You are no longer limited to accessing only one 
program at a time. Top View gives you the freedom to 
change programs as quickly as changing your mind. It 
enables separate programs to work together in the same 
environment. 

Top View enhances your productivity by: 

• Allowing access to more than one program at a 
time 

• Reducing the time needed to end one program and 
start another 

• Making interruptions easier to handle 

• Giving you greater control over your programs 

• Using your computer, time, and programs more 
efficiently. 



What Top View Can Do 



When working within your program without Top View 
you are limited to using only the functions of that 
program. Top View lets you use the functions of your 
program plus the functions of DOS and the Top View 
environment. Within the Top View environment you can: 

Use more than one program at a time 

• Switch between programs without ending them 
Size and move a program's windows 

• Copy and paste information between programs 

• Access many DOS commands through DOS 
Services. 



Using More than One Program 

Top View can manage several programs at once. After 
adding your programs to Top View you can select which 
programs you want to use by simply pressing a button. 
This means you can start several programs in TopView 
and use them at the same time. 

Let's say you are using TopView and have a word 
processor program, a spreadsheet program, and a data 
base program. The data base can be running in the 
system while you are typing a memo with your word 
processor and performing calculations with your 
spreadsheet. 
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Switching between Programs 



You can start several programs and quickly switch from 
one to another. With Top View you can work in one 
program, switch to another, then switch back to the 
original work without having to load and start another 
program. 

Suppose you are typing a memo in the word processor 
program and need to look up a mailing address in the 
data base program. You can quickly switch between the 
word processor and data base program to locate the 
address. With Top View you no longer have to end the 
word processor, start the data base, find and record the 
mailing address, end the data base, restart the word 
processor program, and load the original text. 





Word 
Processor 




o 





Spread 
Sheet 



L. 
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Windowing 



Another feature Top View provides, if your programs 
allow it, is windowing. A window is an area on the 
screen that a program uses to present information to 
the user. With this feature, you can change the size of 
and move a program's windows so you can view several 
programs at a time. 

By sizing the word processor program, you can see the 
address in the data base program at the same time you 
are working on the memo. 



Copying and Pasting Information 

The Scissors feature lets you cut or copy an area of text 
from one program and paste it to another. 

For example, when the data base program locates the 
address, you can copy it from your data base program 
and paste it into your memo. 
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Using DOS Services 



You can also use several of the most common DOS 
commands within Top View. This is convenient since 
you no longer have to end your current program to 
perform DOS functions. DOS Services provides a way 
to execute certain commands without having to type the 
command syntax. 

For example, if you run out of disk space for data files, 
use the DOS Services Erase option to erase any files 
that you no longer need without leaving the Top View 
environment. 



Using Top View's Features 

The ability to use all of Top View's features depends on 
how well your program interacts with TopView. Not all 
programs run with TopView, or if they do, they may 
not be able to use all of Top View's features. However, 
many programs will run with TopView and the ability 
to switch between programs is allowed for all programs. 
Some programs will allow windowing and some can run 
in the background. In addition, some programs do not 
support the Cut and Paste operations. Programs 
written especially for TopView can take advantage of 
all of Top View's features. 



How Top View Works 

Windows 

A window can occupy the entire screen or a portion of 
it. Windows allow you to view data from two or more 
programs at the same time. You can move, hide, 
"un-hide," change the size of, or scroll windows of a 
program without changing the contents of the windows 
of any other programs you may have running. 



Menus 

You access Top View's functions from menus. A menu 
is a list of items from which you choose a specific 
function. You can choose Topview menu items using 
your pointing device. Choosing a menu item is called 
selecting. You will learn how to use your pointing 
device — keyboard or mouse — to select Top View 
functions in the Tutorial. 



Pointer 

The pointer is the block on the screen that allows you to 
point at and select options within a menu. You also use 
the pointer to mark an area of text to be copied or cut, 
and specify in which window a function will be 
performed. 
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Before You Begin 




Before you begin you must: 

• Set up your computer and make sure it is working 
properly. If the computer is not already set up, 
refer to the IBM Personal Computer Guide to 
Operations for instructions on how to set it up. 

• Properly install the mouse if you are using one. 

• Format the fixed disk, if necessary, and copy your 
DOS programs to it. Instructions for formatting 
your fixed disk are in your DOS manual. 

• Go to "Appendix C. Copying Top View" for 
instructions on how to make a backup copy of 
TopView, and how to install Top View on a fixed 
disk. 
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• Make backup copies of the programs you want to 
use with Top View. To prevent having 
incompatible versions of COMMAND.COM, the 
backup copy should not include the 
COMMAND.COM file. 

• If you plan to run programs that open and access 
many disk files, you may want to increase the 
FILES limits allocated when you start your 
computer. Set FILES=20 in the CONFIG.SYS 
file. Refer to "Configuring Your System" in your 
DOS manual for additional information on the 
CONFIG.SYS file. 

• Format any blank diskettes you are planning to 
save data files on. 

It is always a good idea to make a copy of a diskette 
you plan to use regularly. You can put your original 
diskette away for safekeeping and use the backup in 
your everyday work. 

After you make a backup copy of Top View or install 
Top View on your fixed disk, go to "Chapter 2. Getting 
Started" to run Setup and start the Tutorial. 
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Chapter 2. Getting Started 
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Top View Setup Procedure 



In Setup, you tell Top View about some of your 
hardware, including your pointing device. You need to 
go through the Setup procedure only one time. If you 
change the pointing device you are using, you need to 
repeat the Setup procedure. 



Using the Keyboard Pointing Device 

If you are using the keyboard as your pointing device, 
the arrow keys move the pointer, and the Alt, Home, 
and PgUp keys perform Top View operations. You will 
learn more about these keys in the Tutorial. 
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Using Other Pointing Devices 

To use a pointing device other than one of those listed 
in the Setup menu, you must provide a compatible 
device driver. A device driver is a program that allows 
the pointing device to work with Top View. Those that 
come with the pointing device may not be compatible 
unless they were designed for Top View. 

If you are using one of the mouse pointing devices in the 
Setup menu, you can specify either right- or left-handed 
operation when you run the Setup procedure. 

Note: If you are using one of the mice listed in 
Setup, follow the instructions for installing your 
mouse and refer to "Using a Mouse" in "Appendix 
B. Things to Know" for more information. You 
should not follow the software installation 
instructions that came with your mouse because 
Top View provides pointing device drivers for these 
mice. 



Diskette-Based Setup 



This section applies to diskette-based systems 
only. If you have a fixed disk system, refer to 
"Fixed Disk Setup" later in this chapter. 



Before starting the system, you must complete the 
Setup procedure. If you are using a mouse, check now 
to make sure it is properly installed. 
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The following instructions set up the pointing device. 



Note: The instructions below must also be used 
whenever you want to change your pointing device. 

1 Insert your DOS diskette in drive A and close 
the drive door. 

2 Switch your computer on. 

If your computer is already on, press the Ctrl, 
Alt, and Del keys (System Reset). 

When prompted: 

3 Type the date and press Enter. 

4 Type the time and press Enter. 

5 At the DOS prompt, insert your Top View 
backup diskette into drive B and close the drive 
door. 
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6 



Type: 
b: 



and press Enter. 

7 Type: 
setup 

and press Enter. 

The following window appears: 

-Top Vi ew— Setup 



Painting Devices 



1. Keyboard 

2. PC Mouse by Mouse Systems * 

Part Number 900120-214 (Serial Inter-face) 

3. Microsoft Mouse for IBM Personal Computers * 

Model Number 039-099 (Serial Inter-face) 

4. Microso-ft Mouse -for IBM Personal Computers * 

Model Number 037-099 (Parallel Interface) 

5. Visi On Mouse * 

Part Number 69910-1011 (Serial Inter-face) 

6. Other 

Type the number o-f your pointing device: C1D 
Press <h- ' Enter 

* Re-fer to your TopView User's Guide for warranty information. 



Type the number of the pointing device you are 
using and press Enter. 

If you are using a pointing device not listed in 
the Pointing Devices menu, you must provide a 
compatible device driver. Choose Other from 
the menu. Then, when instructed, insert the 
diskette with the device driver program in drive 
A to allow TopView to copy some information 
about your pointing device. 

The next few windows ask for information about 
your mouse, if you are using one, and your color 
display, if you have a color/ graphics monitor 
adapter. 
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y Follow all the directions as they appear. 

The last Setup window displays this message: 

— TopVi ew— Setup 

TopView Setup Complete 

You can: 

1. Start TopView 

2. Return to the DOS prompt 

Enter your choice: CI] 
Press <J— 1 Enter. 



When you get this message, you are ready to use 
TopView. 

10 Press Enter to start TopView and continue with 
the Tutorial. Then continue with the next 
section, "Using the Tutorial," later in this 
chapter. 
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Fixed Disk Setup 



This section applies to fixed disk systems 
only. If you have a diskette-based system, 
refer to "Diskette-Based Setup" earlier in 
this chapter. 



Before starting the system, you must complete the 
Setup procedure. If you are using a mouse, check now 
to make sure it is properly installed. 

If you have not already installed Top View on your fixed 
disk, go to "Appendix C. Copying Top View" before 
starting the Setup procedure. 

The following instructions set up the pointing device. 

Note: The instructions below must also be used 
whenever you want to change your pointing device. 

Switch your computer on. 

If your computer is already on, press the Ctrl, 
Alt, and Del keys (System Reset). 

When prompted: 
Type the date and press Enter. 
Type the time and press Enter. 



1 

2 

3 
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4 



After the DOS prompt, type: 



d: 

Note: When using a fixed disk system, you 
can specify which drive Top View is on. 
The d parameter denotes any fixed disk 
drive you have installed Top View on. 

and press Enter. 

5 Now type: 
cd \topview 

and press Enter. 

6 Then type: 
setup 

and press Enter. 

The following window appears: 

— TopVi ew— Setup 



Pointing Devices 



1. Keyboard 

2. PC Mouse by Mouse Systems * 

Part Number 900120-214 (Serial Inter-face) 

3. Microsoft Mouse -for IBM Personal Computers * 

Model Number 039-099 (Serial Interface) 

4. Microsoft Mouse for IBM Personal Computers * 

Model Number 037-099 (Parallel Interface) 

5. Visi On Mouse * 

Part Number 69910-1011 (Serial Interface) 

h. Other 

Type the number of your pointing device: CI] 
Press <3 — 1 Enter 

* Refer to your TopView User's Guide for warranty information. 



V Type the number of the pointing device you are 
using and press Enter. 
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If you are using a pointing device not listed in 
the Pointing Devices menu, you must provide a 
compatible device driver. Choose Other from 
the menu. Then, when instructed, insert the 
diskette with the device driver program in drive 
A to allow Top View to copy some information 
about your pointing device. 

The next few windows ask for information about 
your mouse, if you are using one, and your color 
display, if you have a color/ graphics monitor 
adapter. 

8 Follow all the screen directions in the order they 
are given. 

The last Setup window displays this message: 

— TopVi ew— Setup 1 



TopView Setup Complete 

You can: 

1. Start TopView 

2. Return to the DOS prompt 

Enter your choice: 111 
Press < — 1 Enter. 



When you get this message, you are ready to use 
TopView. 

Press Enter to start TopView and continue with 
"Using the Tutorial." 
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Using the Tutorial 



What the Tutorial Teaches 

The Tutorial teaches you how to use Top View. It 
introduces you to some basic functions and is a 
"hands-on" tool for you to use in learning Top View. 

If this is the first time you use TopView, you should 
complete the entire tutorial. Then use the menu options 
to review a specific feature. 

The features presented in the Tutorial are: 

• Using your pointing device 

• Getting help 

• Adding your programs to TopView 

• Starting your programs 

• Switching between your started programs 

• Copying information from one window and pasting 
it into another window 

• Quitting a program 
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• Windowing a program 

• Scrolling information in a window 

• Using TopView's DOS Services 

• Exiting Top View 



Starting the Tutorial 



Now that you have completed Setup, you are ready to 
begin the Tutorial. 

After starting Top View, the IBM logo window flashes 
and the following window appears: 



*>•'.;.<;-:< Welcome ".»! >.>? 



Press | T | to use the TopView Tutorial 
Press | <j— 1 1 to continue 

Press 
T 

The following message appears: 



Insert your TopView Tutorial diskette into drive A. 
Press <— J Enter. 
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If your DOS diskette is in drive A, remove it. 
Insert the diskette labeled "TopView Tutorial" 
into drive A. Close the drive door and press 
Enter. 

Note: When running the Tutorial, you 
cannot switch to other programs running in 
TopView without first quitting the Tutorial. 

Your next window is: 



WELCOME TO THE TOPVIEW TUTORIAL 



If you have completed the Setup procedure described in the TopView 
User's Guide, indicate what type of pointing device you are using. 
Otherwise, Exit the Tutorial now and run the Setup procedure. 

Choose your pointing device, or type '4' to Exit the Tutorial. 

1. Keyboard Pointing Device 

2. Two Button Mouse 

3. Three Button Mouse 

4. Exit Tutorial 

Type the number of your choice and press <— 1 Enter: [13 



3 You are now at the first Tutorial window. 

Follow the instructions in this window. They 
will take you through the Tutorial, step-by-step. 

If your printer is on, you can print any Tutorial window 
by pressing the Shift and PrtSc keys at the same time. 

When you finish the Tutorial, return to "Chapter 3. 
About the TopView Program" for a review and some 
additional information on using TopView. Refer to 
"Appendix B. Things to Know" for instructions on 
starting TopView using option codes. If you have a 
diskette-based system, you should note the /F option. 

Meanwhile, take your time learning TopView and have 
fun! 
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If you are joining us from the Tutorial, welcome back! 
We hope you enjoyed it. If you have not completed 
Setup and the Tutorial, please go to "Chapter 2. 
Getting Started" and do so now. 

This chapter tells you more about the TopView 
program. Read this chapter before you continue using 
TopView. 



Using Your Pointing Device 

The pointing device controls the movement of the 
pointer. The pointer is used to perform TopView 
functions such as selecting items from a menu, marking 
text to be copied or cut, and specifying in which 
window a function will be performed. 

Pointer versus Cursor 

The pointer is the block on your screen that you point 
with. In graphics mode the pointer is an arrow. The 
cursor is the blinking line, or hardware cursor, that 
appears inside the foreground window. It marks the 
location where you enter data from the keyboard. 

You may see both the pointer and the cursor in a 
window at the same time. If you see the pointer in a 
window when using the keyboard pointing device, you 
know that you are in TopView mode. In this mode, the 
arrow keys control pointer movement. This is discussed 
in more detail in the next section. 

Note: When running programs that are not 
specifically written for TopView, the pointer may 
be invisible. The pointer will reappear when you 
display the TopView menu. 
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For Top View programs, such as DOS Services, the 
pointing device can be used to position the cursor in an 
input field where data is to be typed. Do this by 
following these steps: 

• Use your pointing device to move the pointer to the 
place you want the cursor to appear. It can be 
anywhere in a field that expects character input. 

• Press Button 1 . 

The cursor automatically jumps to the pointer location. 
Moving the cursor this way is especially helpful in 
Top View windows that ask you to enter information. 



Using the Keyboard Pointing Device 

Specific keys can perform both Top View functions and 
your program functions. To perform TopView functions, 
the keyboard must be in TopView mode. You hear a 
beep each time you toggle in or out of TopView mode. 
When in TopView mode, a beep sounds when you 
move the pointer or press a pointing device button. 
This tells you that the keyboard pointing device is 
active. 

While in TopView mode, the arrow keys, PgUp key, 
Home key, 5 key and plus and minus keys on the 
numeric keypad perform TopView functions. When 
not in TopView mode, these keys perform their normal 
functions within your program. 
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Top View Toggle Key 



Press the Control (Ctrl) key to 
toggle in and out of Top View 
mode. Pressing the Ctrl key 
once puts the keyboard in 
TopView mode. Pressing the 
Ctrl key a second time takes 
the keyboard out of TopView 
mode. A beep sounds when 
you press the Ctrl key to let 
you know you are toggling in 
or out of TopView mode. 



TopView Menu Key 



Press Button 3, the Alt key, to 
display the TopView menu and 
at the same time, toggle into 
TopView mode. Pressing 
Button 3 two times quickly 
allows you to switch from one 
program to the next. This lets 
you cycle through the 
programs you have started. 
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Top View Action Keys 



Once your keyboard is in Top View mode, these keys 
perform the following actions: 



Home 



Use Button 1, the Home key, 
to make menu selections. 



PgUp 



Use Button 2, the PgUp key, to 
cancel or end an operation. 



t 



Each arrow key moves the 
pointer one position in the 
direction of the arrow. 

When you press and hold the 
Ctrl key together with any of 
the arrow keys, the pointer 
moves several positions at a 
time. 



+ 



You can increase the number 
of positions that the pointer 
moves when you use the Ctrl 
key together with an arrow 
key. Do this by pressing the 
plus key to increase the 
number of positions the pointer 
moves, up to 24 horizontal 
positions or 12 vertical 
positions. 



You can decrease the number 
of positions that the pointer 
moves when you press the Ctrl 
key together with an arrow 
key. Do this by pressing the 
minus key to decrease the 
number of positions the pointer 
moves to a minimum of two 
horizontal positions or one 
vertical position. 



Press the 5 key on the numeric 
keypad to turn the sound on or 
off when in Top View mode. 



Top View Mode 

Remember that you must first toggle out of Top View 
mode, by pressing the Ctrl key, before you move the 
cursor using the arrow keys. In TopView mode, the 
arrow keys control the movement of the pointer. When 
you are working in your program, the arrow keys may 
be used to perform the cursor movement functions 
within your program. You should toggle out of 
TopView mode to use the numeric keypad for its 
normal function within your program. 

Remember, the Alt key used to display the TopView 
menu also toggles you into TopView mode. 



Using a Mouse Pointing Device 

There are several kinds of mice you can use with 
TopView. Some have two buttons, while others have 
three. TopView defines certain buttons on all mice as 
Button 1, Button 2 and Button 3. The Tutorial explains 
how to use these buttons. 
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Foreground and Background Programs 



As you learned in the Tutorial, a foreground program's 
windows appear with a double border unless the 
program uses the full screen. More than one program 
can be running in the background. 

You can enter data and make menu selections only in 
the foreground program. You bring a program to the 
foreground by: 

• Selecting its name from the Start a Program menu 
if you have not already started it. 

• Selecting its name from the Switch list if you have 
already started it. 

Moving the pointer anywhere within one of the 
program's windows and pressing Button 3 twice 
quickly. 

If the pointer is in the foreground window, press Button 
3 twice quickly to move the next available program in 
the Switch list to the foreground. This feature allows 
you to cycle through the programs you have started in 
the Top View system. You cannot cycle to a program 
you have hidden or suspended. 




1 Background 
| Programs 



Foreground 
Program 



J 
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Top View Features and Your Programs 



Some programs do not take advantage of every 
TopView feature. For example, some program's 
windows cannot be sized, some windows' contents 
cannot be scrolled, and some programs cannot run in 
the background. TopView lets you know which options 
your program can use by displaying a block in front of 
those options on the TopView menu that are selectable. 
If you see the block in front of Window, for example, 
you can select it. 
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Top View Menu Options 



Once you add and start programs, you can switch from 
one program to another, window, scroll, and copy 
information from one window and paste it into another. 
You do this by selecting options from the Top View 
menu. The menu chart at the end of this chapter 
outlines the Top View menu and summarizes each 
option's function. 

Anytime you display the TopView menu, it appears at the 
location of the pointer. The features your program 
allows are preceded by a block. 

Note: An important fact to remember about the 
first six options in the TopView menu is that the 
pointer must be inside the window you want to use 
before you display the TopView menu. This 
determines in which window you want the function 
performed. 
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When you select an item from the Top View menu, that 
menu disappears and a submenu, if one is provided, 
appears. Pressing Button 2 makes most menus 
disappear. 

The Top View menu is divided into two sections: 



The top section contains 
functions that can be 
performed on your programs. 



— TopView 
□ Scroll 



□ Window 

□ Scissors 

□ Help 



□ Suspend 

□ Quit 



The bottom section contains 
TopView system functions. 



□ Switch 

□ Programs 

□ Exit 
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Scroll 




The Scroll option allows you to view the portion of the 
program's data that is outside the window. When you 
scroll, move the pointer in the direction you want to 
scroll. The text appears to move in the opposite 
direction. If the window you are scrolling contains the 
cursor, you cannot scroll the text in a direction that 
would move the cursor out of the window. This is so 
that you will always be able to see what you are typing. 

If you are using the keyboard pointing device, the arrow 
keys control the direction of scrolling. One press of an 
arrow key causes the text to scroll once in the direction 
of the arrow. Pressing the Ctrl key together with any 
arrow key causes the text to scroll several positions in 
the direction of the arrow. 

Scrolling with a mouse is similar. Moving the mouse in 
any direction causes the text to scroll in that direction. 
The distance you move the mouse determines the 
distance the text scrolls. 
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Normally, Top View scrolls the text according to the 
distance you move the pointer. If you want the text to 
be scrolled automatically, press Button 1 once and 
release it. Now move the pointer in the direction to 
scroll the text. Scrolling continues even though you 
stop moving the pointer. This automatic form of 
scrolling is useful for browsing long lists of text. 

If you continue to move the pointer in the same 
direction, the rate of scrolling increases. If you move 
the pointer in the opposite direction, the rate of 
scrolling decreases. If you continue to move the pointer 
in the opposite direction, scrolling eventually stops. If 
you continue again, scrolling reverses and goes in the 
direction you are moving the pointer. 

You can resume the original, manual form of scrolling 
at any time by pressing and releasing Button 1 again. 

Whenever you select Scroll from the Top View menu, 
you always start in the manual form of scrolling. 

Pressing Button 2 ends the Scroll option. 
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Window 




The Window option allows you to change the size or 
position of a program's windows. Selecting Window 
gives you a submenu with five options: Move, Size, 
Zoom, Unzoom, and Hide. 

Window 

□ Move 

□ Size 

□ Zoom 

□ Unzoom 

□ Hide 



Move 

Move lets you move the window in which the pointer is 
located to a different position on the screen. To move a 
window, be sure the pointer is within the window, 
select Move, and move the pointer in the direction you 
want the window to move. 
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You cannot move a window off the screen; it will stop 
moving when a screen edge is reached. Press Button 2 
to end Move. 



Size 

Size lets you change the dimensions of a window. 
When you move the pointer, the window changes size 
depending on where in the window the pointer is 
located when you displayed the TopView menu. For 
example, if the pointer is in the upper left corner, you 
can size the window from the top or left side. 




End Size by pressing Button 2. 
Zoom 

Selecting Zoom returns a sized window to its full size. 



Unzoom 

Selecting Unzoom restores a zoomed window back to its 
previous size and position. 



3-15 



Hide 



Selecting Hide removes a window from your view. All 
related program windows are also hidden. The 
program, however, may still be running. 

Each hidden program has a dash by it on the Switch list. 
To view the hidden program again, you must select 
Switch from the TopView menu, then select the 
program name from that list. 

You can use Hide to temporarily remove the windows 
of programs that are not critical to the current work 
you are doing in the system. 

Note: You cannot use the double-button-press 
method to switch to a hidden program. 
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Scissors 




The Scissors option allows you to transfer information 
between or within program windows. Selecting Scissors 
gives you a submenu with three options: Cut, Copy and 
Paste. 

uciucors 

:i Cut 
: ] Copy 



You can copy or cut up to a screenful of text at a time. 
Once a copy or cut is completed, Top View holds the 
information temporarily until another copy or cut is 
performed. Until then, you can continue to paste the 
information you copied or cut. 

Notes: 

1 . If you move the pointer out of the window it was 
in when Scissors was selected, no action occurs 
during any Scissors operation. For example, if you 
move the pointer out of the window while marking 
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an area to be copied, the marking stops. As soon 
as you move the pointer back into the window, 
marking resumes. 

2. To allow the Scissors operations to work correctly 
in your program, you must not redefine the normal 
functions of the keys in your program. 



Cut 

Cut allows you to delete information from a window. 

To cut, follow the same procedure as Copy below, but 
select Cut from the Scissors submenu. The information 
you cut is deleted. 



Copy 

Copy allows you to copy information from a window, 
while retaining the information in the original window. 
Top View holds copied information temporarily until 
another copy or cut is performed. Copy is available for 
all non-graphics programs. 

To copy: 

• Display the Top View menu. 

• Select Scissors. 
Select Copy. 

• Position the pointer at the start of text to copy. 

• Press Button 1. 

• Move the pointer to the end of text to copy. 

As you move the pointer, a marked area appears 
on the screen and moves with the pointer. 
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When the marked area contains all the text you 
want to copy, press Button 1. 



• A Confirm message appears. 



• Press Button 1 if you are sure the area is marked 
correctly. The text is stored in the Copy/ Cut 
storage area. 

If you decide to cancel the Copy function, press Button 
2 while the pointer is on the Confirm message. You 
can also cancel the Copy function any time before the 
Confirm message is displayed by pressing Button 2. 



Paste 

Paste displays the information you have copied or cut 
and allows you to insert the information in a window. 
You cannot perform the Paste function until you copy 
or cut text. 

To use Paste: 

• Display the Top View menu. 

• Select Scissors in the window where you want to 
paste the copied or cut information. 

• Select Paste. 

After you select Paste, a window appears. 

• As you move the pointer, the window moves with 
it. This window is allowed to move beyond the 
right and bottom edges of the screen. 

• Press Button 1 to paste the information. 
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Press Button 1 again to confirm the operation. 



Paste inserts the marked text after you confirm the 
operation. 

Note: The program you paste into must be in text 
entry mode. For example, if you try to paste when 
the cursor is on a command line that accepts only 
function key entry, the marked text is not pasted. 

You can continue to paste the same information until 
another copy or cut is performed. 

When you paste text into a document from a program 
that uses Top View's filter program, the existing lines of 
text move down to make room for the marked text. 
The Top View filter program is used to allow programs 
not written specifically for Top View to make use of the 
Scissors operation. 
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Help 




The Help option allows you to get information on the 
current operation you are performing. If the program 
in which you are working allows Help, a block appears 
in front of Help on the Top View menu. Help is 
available for Programs, DOS Services, Alarm Clock, 
Calculator, and the Color Change Program that 
TopView provides. Any other programs written 
especially for TopView can also make use of the Help 
option. 

Some programs provide multiple pages or menus of help 
information. You can page forward or backward, or 
access a menu, by selecting the Forward, Backward, or 
Menu options from the bottom of the Help window, or 
by typing F, B, or M respectively. 

You can leave Help and return to your program by 
pressing Q or selecting Quit from the bottom of the 
Help window. 
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Suspend 




The Suspend option allows you to temporarily halt a 
program that is running. It also hides all of its 
associated windows. An asterisk appears next to the 
suspended program's name on the Switch list to remind 
you that this program was suspended. 

You might, for example, want to Suspend a program 
that is running in the foreground to do another task. 
You can then resume the program by selecting Switch 
from the Top View menu and then selecting the 
suspended program. This returns the suspended 
program to the foreground. 

Note: You cannot use the double-button-press 
method to switch to a suspended program. 
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Quit ends a program. Do this by displaying the 
Top View menu in any window of the program you want 
to quit and selecting Quit. There must be a block in 
front of Quit in the Top View menu. The program in 
which you select the Quit option determines whether 
the Quit option is allowed. 

After you select Quit, a Confirm option appears. Press 
either Button 1 to confirm or Button 2 to cancel. 

Notes: 

1 . Save your work before you quit the program. 

2. To insure that you don't lose data, end your 
program using the function for exiting provided in 
your particular program. 



3-23 



Switch 




The Switch option allows you to move from one started 
program to another. The Switch list appears when you 
select Switch from the Top View menu. It contains a list 
of programs started during the current work session. 
Program names appearing in the Switch list have special 
marks in front of them. 

• A block means the program is currently running. 

A dash means the program's windows are hidden. 
(The program may still be running.) 

• An asterisk means the program is suspended. 

r- Switch 1 

□ Database 

— Word Processor 

* Spreadsheet 



3-24 



If you select a hidden program, the program's windows 
appear in the foreground. If you select a suspended 
program, it resumes processing and its windows appear 
in the foreground. 

Numbers are assigned in the Switch list to each copy of 
a program you start. When more than nine copies of the 
same program are running, letters are assigned for the 
remaining copies. 

To switch between programs, select the name of the 
program from the Switch list. 
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Programs 




Selecting Programs from the Top View menu displays 
the Start a Program menu. 



Start a Program 

r— Start-a-Program — 
□ DOS Services 



n Add a Program to Menu 

□ Delete a Program from Menu 

□ Change Program Information 



This menu contains the titles of the programs that you 
added, and the following Programs options: Add a 
Program to Menu, Delete a Program from Menu, and 
Change Program Information. 

The items in the menu are selectable based on the 
amount of storage available in your system. 
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You can scroll the Start a Program menu, if all the 
programs you have added do not appear in the list, by 
using the Scroll option. A beep sounds when you reach 
the top or bottom of the list of programs. 



Add a Program to Menu 

This option allows you to give TopView information 
about a program you want to use and adds its title to 
the Start a Program menu. You do this by selecting Add 
a Program to Menu from the Start a Program menu. 



Delete a Program from Menu 

This option allows you to delete a program's title from 
the Start a Program menu. You delete a program's 
name by selecting Delete a Program from Menu from 
the Start a Program menu. Then, select the title of the 
program you want to delete. 



Change Program Information 

This option allows you to view or change the 
information TopView currently has on your program. 
Do this by selecting Change Program Information from 
the Start a Program menu. Then, select the title of the 
program you want to change. 

For example, if you have moved the location of your 
program from one directory to another, or to allocate 
more memory to your program, you will need to change 
Top View's information about your program. 
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Exit 




The Exit option allows you to end Top View and return 
to DOS. 

To Exit, you must first quit all other programs you have 
started. Remember to save any work you have done in 
your programs before you quit them. 

After you select Exit, a confirm option appears. Press 
Button 1 to confirm or Button 2 to cancel. 

Note: The difference between Quit and Exit is that 
Quit takes you out of your program and Exit takes 
you out of Top View. 
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Top View Menu Chart 

The following chart summarizes the Top View Menu 
options. 



Scroll Moves the contents of the window in the 

opposite direction of the pointer movement 



Window 



Move 
Size 



Zoom 
Unzoom 



Hide 



Moves a window around the screen 
Allows you to make a window larger 
or smaller 

Expands a window to its full size 
Restores a window to the size it was 
before selecting Zoom 

Removes a program and its associated 
windows from view 



Scissors Cut Deletes marked text from a window and 

places it in the Copy/Cut storage area 
Copy Copies marked text into the 

Copy/Cut storage area 
Paste Inserts data from the Copy/Cut storage 
area into a window 



Help 



Gives information on the 
current operation 



Suspend 



Temporarily stops a program and 
hides all of its associated windows 



Quit 



Ends a program 



Switch Lists the programs that have been started 

during the current work session 



Programs Start a Program 



Add a Program 

to Menu 
Delete a Program 

from Menu 
Change Program 

Information 



Lists the programs added to TopView 

and starts a program when 

it is selected from the list 

Adds a program to the 

Start a Program menu 

Deletes a program from the 

Start a Program menu 

Keeps a record of information that 

TopView needs to run your program 



Exit 



Ends TopView and returns you to DOS 
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Chapter 4. Starting Top View and Adding 
Your Programs 
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Starting Top View on a Diskette-Based System . . 4-3 

Starting Top View on a Fixed Disk System 4-7 

Adding Your Programs to Top View 4-10 

How to Add Programs to Top View 4-12 

Adding the Alarm Clock Program 4-17 

Using the Alarm Clock Program 4-20 

Adding the Calculator Program 4-21 

Using The Calculator Program 4-23 

Starting Programs With Top View 4-24 

On a Diskette-Based System 4-24 

On a Fixed Disk System 4-25 



4-1 



4-2 



Follow these instructions for starting TopView for 
everyday use. When you are familiar with starting 
TopView refer to "User Options" in "Appendix B. 
Things to Know" for a quick way to specify certain 
defaults. 




This section applies to diskette-based systems 
only. If you have a fixed disk system, refer to 
"Starting TopView on a Fixed Disk System" later in 
this chapter. 



Because some programs can be started only from drive 
A, we give you instructions for running TopView from 
drive B. 
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If you are joining us from the Tutorial, and the Start a 
Program window is on the screen or if you just started 
Top View and the Welcome window is displayed, go to 
"Adding Your Programs to Top View," later in this 
chapter. 

REMINDER: If you did not go through the Setup 
procedure in "Chapter 2. Getting Started" or if you 
wish to change your pointing device, you must do that 
now. 



Insert your DOS diskette in drive A and close 
the drive door. 

Switch your computer on. 

If your computer is already on, press the Ctrl, 
Alt, and Del keys (System Reset). 

When prompted: 

Type the date and press Enter. 



4 



Type the time and press Enter. 



At the DOS prompt, A>, insert your TopView 
backup diskette into drive B and close the drive 
door. 




Type: 

b: 

and press Enter. 



7 Type: 



g /f 

and press Enter. 

Note: There are certain option codes you 
can specify when you start Top View by 
typing them along with the G command. 
These option codes automatically tell 
Top View how you want your system to run. 
For information about the F option and 
other option codes, refer to the "User 
Options" section of "Appendix B. Things to 
Know." 

After the IBM logo window flashes, the 
following window appears: 
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Press I T to use the TopView Tutorial 



Press <] — 1| to continue 



When you press Enter, the Start a Program menu 
appears on the screen. 

Now go to the section called: "Adding Your Programs 
to Top View" later in this chapter. 
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Starting Top View on a Fixed Disk 
System 




This section applies to fixed disk systems only. 
If you have a diskette-based system, refer to 
"Starting TopView on a Diskette-Based System" 
earlier in this chapter. 



If you are joining us from the Tutorial, and the Start a 
Program window is on the screen or if you just started 
TopView and the Welcome window is displayed, refer 
to "Adding Your Programs to TopView," later in this 
chapter. 

REMINDER: If you did not go through the Setup 
procedure in "Chapter 2. Getting Started"or if you 
wish to change your pointing device, do that now. 
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Switch your computer on. 

If your computer is already on, press the Ctrl, 
Alt, and Del keys (System Reset). 

When prompted: 

Type the date and press Enter. 

Type the time and press Enter. 

At the DOS prompt, if you are not in your root 
directory, type: 

d: 

Note: When using a fixed disk system, you 
can specify which drive Top View is on. 
The d parameter denotes any fixed disk 
drive you have installed Top View on. 

and press Enter. 

Now type: 
cd \ 

and press Enter. 



6 Then type: 



topview 

and press Enter. 

Note: There are certain option codes you 
can specify when you start Top View- by 
typing them along with the TOPVIEW 
command. These option codes 
automatically tell TopView how you want 
your system to run. For information about 
option codes and their meanings, refer to 
the "User Options" section of "Appendix 
B. Things to Know." 

After the IBM logo window flashes, the 
following window appears: 



< <•■;.;.< Welcome " 



>i;jX > tO }'),.: > >>>: 



Press I T to use the TopView Tutorial 



0 



Press <j— I to continue 



When you press Enter, the Start a Program menu 
appears on the screen. 
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Adding Your Programs to Top View 




When you add a program you provide Top View with 
information about the program. TopView does not 
check to make sure the actual program exists. The add 
process simply adds the program title to the Start a 
Program menu and updates the TopView Program 
Information File. A program information file contains 
the memory amount, filename, and title of a program. 

If this is the first time you're using the program you are 
about to add, follow the instructions in your program's 
documentation to make a backup copy or install it on 
your fixed disk. After you have done this, return here. 

You need to add a program only once. TopView 
remembers the added programs even after you turn off 
your computer. Deleting a program, however, means 
that you must re-add it if you want to use the program 
with TopView again. If the program being deleted is 
one of the programs in the Add a Program list, then 
TopView retains the program's information. If the 
program being deleted was added through Other, then 
the program's information is lost. 
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When you select Add a Program to Menu, the Add a 
Program list containing the program titles of the IBM 
programs supported by Top View is displayed. If you 
are adding a program from the Add a Program list, 
TopView already has that program's information. You 
need only supply the drive and directory location of the 
program. 

If you are adding a program through Other, TopView 
asks you for the drive and directory location of your 
program, and then looks for the information about your 
program where you specified. If TopView doesn't find 
it, TopView asks you to supply the title, filename, and 
memory requirements of your program. TopView uses 
preassigned or default values for the remaining 
information. In most cases, the defaults allow your 
program to perform adequately with TopView. The 
defaults include not allowing the program windowing 
capabilities or the ability to run in the background. 
Refer to "Chapter 6. Changing Program Information," 
for more information. 

After the Add a Program process, TopView displays a 
message indicating that your program has been added. 
You can then start the program by selecting its name, 
which now appears in the Start a Program menu. If you 
had previously added the program, a message stating 
that your program has already been added will appear. 

You are now ready to begin running programs under 
TopView. If you would like to practice adding 
programs, add the Alarm Clock and the Calculator 
programs that are provided with TopView. Instructions 
for adding the Alarm Clock program are in "Adding the 
Alarm Clock Program" on page 4-17. Instructions for 
adding the Calculator program are in "Adding the 
Calculator Program" on page 4-21. The following are 
general instructions for adding programs. 
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How to Add Programs to Top View 

Note: If you have the Start a Program menu on 
your screen, you should begin at step 3. 



Display the Top View menu. 



Select Programs from the Top View menu. 

Select Add a Program to Menu from the Start a 
Program menu. 

The following window appears: 



■-St i-Add— a— Proqram- 



Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clack 
BASIC 

BASIC Compiler 

BASIC Prog. Dev. Sys. Editor 
BASIC Prog. Dev. Sys. Form 
BASICA 

COBOL Compiler 

DisplayWrite 1 

DisplayWrite 2 Version 1.1 

DOS Services 

EasyWriter 1. IS 

FORTRAN Compiler 1.0 Pass One 

FORTRAN Compiler 1.0 Pass Two 

FORTRAN Compiler 2.0 Pass One 

FORTRAN Compiler 2.0 Pass Two 

IBM Filing Assistant 

IBM Graphing Assistant 

IBM Reporting Assistant 

IBM Writing Assistant 





Li nker 








Macro Assembler 1.0 






■ 


Multiplan 1.1 






■ 


Pascal Compiler 1.0 


Pass 


One 


■ 


Pascal Compiler 1.0 


Pass 


Two 




Pascal Compiler 2.0 


Pass 


One 


I 


Pascal Compiler 2.0 


Pass 


Two 


■ 


Pascal Compiler 2.0 


Pass 


Three 




PC Cluster 






■ 


PCWriter 






I 


PeachText 






■ 


Personal Communications Mgr. 


■ 


Personal Editor 






■ 


Professional Editor 






■ 


Script/PC 






1 


Sort 






■ 


VisiCalc 1.2 






■ 


Word Proof 






■ 


Other 







Note: This is an example of the window 
that appears on your screen. The actual 
programs listed may differ. 



Select the name of the program you want to add. 
If that program does not appear in the list, select 
Other. 
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After the word "Path" in the next window, type 
the drive location of your program if it is not in 
drive A. Include the appropriate directory 
location. 



j-Add— a— Program 

Select a program to ADD to the Start a Program Menu. 



■ 3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 
BA r-Program— Location- 



■ Linker 

• Macro Assembler 1.0 

■ Multiplan 1.1 

■ Pascal Compiler 1.0 Pass One 



BA 
BA 
CO 
Di 
Di 
DO 
Ea 
FO 
FO 
FO 
FO 

IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



Type the path (drive and directory), if different -from below, 
where TopView can -find your program(s). 

Path: Ca:\ ] 
TopView will look for program information in the above location. 
Press <}— 1 Enter 



VisiCalc 1. 
Word Proof 



Press Enter. 

If you are adding a program listed on the Add a 
Program list, you will see a message telling you 
your program was added. Press Button 2 to quit 
Add a Program. 
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Adding Programs through Other 

If you selected Other, Top View searches the 
location you specified for program information 
files. If any are found, a menu listing the titles 
of these programs is displayed. To add these 
programs: 

• Select the titles you want to add to the Start 
a Program menu. 

• If you want to add a program that is not on 
the list, select Other. 

» Press Button 2 when you have finished 
selecting. 

Press Button 2 to quit Add a Program. 

When you add programs with program 
information files, Top View assumes you will run 
those programs from the same drive and 
directory that they were added. If Top View 
finds a file with an extension of .PIF, and it is 
not a valid program information file, an error 
occurs. 



If Top View found no program information files, 
or if you selected Other from the Add Other 
menu, the following window appears: 



-Add— a— F'ragram 

Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clack 
BASIC 

BA rAddi t i anal — I n-f or mat 1 an- 
BA 
BA 
BA 
CO 
Di 
Di 
DO 
Ea 
FO 
FO 
FO 



■ Linker 

• Macro Assembler 1.0 

• Multiplan 1. 1 



Program Title : C 

Program Filename : C ] 

Memory Requirements..: C 523 KB 

Press <}— 1 Enter 
Note: Press the Tab key to move between entries. 



FO 

IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



VisiCalc 1. 
Word Proof 



One 
Two 
One 
Two 
Three 



Mgr . 



8 If you get this window, type the program title, 
the program filename and the amount of 
memory your program requires. Then press 
Enter. 

• The program title can be any name, up to 
30 characters, that you want to call your 
program. 

• If you do not know your program filename, 
locate it by using DOS Services to display 
the directory. With the directory displayed 
look for a file with either a .COM or .EXE 
extension. The program filename is usually 
a shortened form of the program's name, 
followed by one of these extensions. 
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If some doubt still exists as to the correct 
name, look for a file called 
AUTOEXEC.BAT. If it is present, display 
it by selecting the DOS Services Type 
option. Then, look at the contents of that 
file. One of the lines in the 
AUTOEXEC.BAT file most likely 
corresponds with the name of either the 
.COM or .EXE file on the diskette. 



• You can find the amount of memory the 
program requires in the program's 
documentation. TopView assigns a default 
memory amount of 52KB for the program. 



" After you receive a message telling you the 
programs were added to the Start a Program 
menu, press Button 2 to quit Add a Program. 

For practice in adding programs, add the Alarm Clock 
and Calculator programs. Instructions on how to add 
these programs are on the following pages. 
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Adding the Alarm Clock Program 



The Alarm Clock program allows you to set the date, 
time, and up to five alarms. Each alarm can have an 
associated message. When the set time is reached, an 
alarm sounds and the message is highlighted in the 
Alarm Clock window. 

To add the Alarm Clock program: 

1 Display the Top View menu. 

2 Select Programs from the Top View menu. 

3 Select Add a Program to Menu from the Start a 
Program menu. 

The following window appears: 



rSt rAdd— a— Program- 



Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 

BASIC Prog. Dev. Sys. Editor 
BASIC Prog. Dev. Sys. Form 
BASICA 

COBOL Compi ler 

DisplayWrite 1 

DisplayWrite 2 Version 1.1 

DOS Services 

EasyWriter 1.15 

FORTRAN Compiler 1.0 Pass One 

FORTRAN Compiler 1.0 Pass Two 

FORTRAN Compiler 2.0 Pass One 

FORTRAN Compiler 2.0 Pass Two 

IBM Filing Assistant 

IBM Graphing Assistant 

IBM Reporting Assistant 

IBM Writing Assistant 



• Linker 






■ Macro Assembler 1.0 






• Multiplan 1. 1 






■ Pascal Compiler 1.0 


Pass 


One 


• Pascal Compiler 1.0 


Pass 


Two 


• Pascal Compiler 2.0 


Pass 


One 


• Pascal Compiler 2.0 


Pass 


Two 


■ Pascal Compiler 2.0 


Pass 


Three 


■ PC Cluster 






■ PCWriter 






■ PeachText 






■ Personal Communications Mgr. 


■ Personal Editor 






■ Professional Editor 






• Script/PC 






• Sort 






• VisiCalc 1.2 






■ Word Proof 






■ Other 



Note: This is an example of the window 
that appears on your screen. The actual 
programs listed may differ. 

4 Select Alarm Clock from the Add a Program list. 
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5 After the word "Path" in the next window, type 
the drive location of your program, which is the 
same location as the Top View program. If you 
are using a diskette-based system, type: 

b:\ 

If you are using a fixed disk system, type: 
d: \topview 

Where d is the fixed disk drive. 



St rAdd— a-Program- 



Select a program to ADD to the Start a Program Menu. 



Type the path (drive and directory) 
where TopView can -find Alarm Clock 



Path: Ca:\ 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 
BA pPragram-Location- 
BA 
BA 
CO 
Di 
Di 
DO 
Ea 
FO 
FO 

FORTRAN Compiler 2.0 Pass One 
FORTRAN Compiler 2.0 Pass Two 
IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



■ Linker 

■ Macro Assembler 1.0 
» Multiplan 1.1 

■ Pascal Compiler 1.0 Pass 



if different -from below, 



F'ress <— 1 Enter 



Script/PC 
Sort 

VisiCalc 1.2 
Word Proof 



Other 
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6 



Press Enter. 

The following window appears: 



pSt [-Add— a— Pr ogr am- 



Select a program to ADD to the Start a Program Meni. 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 
BASIC Prog. Dev. Sys. 
BASIC PpAdd-Status- 
BASICA 

COBOL C Alarm Clock 
Di splay 
Di spl ay 
DOS Ser 
EasyWr i 

FORTRAN Compiler 1.0 Pass One 
FORTRAN Compiler 1.0 Pass Two 
FORTRAN Compiler 2.0 Pass One 
FORTRAN Compiler 2.0 Pass Two 
IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



■ Linker 

■ Macro Assembler 1.0 

■ Multiplan 1. 1 

■ Pascal Compiler 1.0 Pass One 

■ Pascal Compiler 1.0 Pass Two 

One 
Two 



added 



Press Button 2 to quit Add a Program 



Personal Editor 
Professional Editor 
Script/PC 
Sort 

VisiCalc 1.2 
Word Proof 



ss Three 



s Mgr . 



Other 



To leave Add a Program, press Button 2. 
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Using the Alarm Clock Program 



After adding the Alarm Clock program, you can use it 
to set the date, time, and up to five alarms. 

Start the Alarm Clock by selecting it from the Start a 
Program menu. To set the time, place the pointer over 
the words Set Time on the Alarm Clock window. Press 
Button 1 and the pointer and cursor move to the field 
where you type in the correct time. 

Use the same procedure with the Set Date and alarms 
1-5. You can find additional information on this 
program by displaying the Top View menu over the 
Alarm Clock window, and selecting Help. 

After the alarm times are set, you can continue your 
work with other programs you switch to or start. Alarm 
Clock will sound an alarm at the set times. 
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Adding the Calculator Program 

The Calculator program allows you to add, subtract, 
multiply, divide, and get percentages and square roots 
of numbers. It also provides a worksheet that displays 
your calculations, and memory that stores them. Since 
this program is not on the Add a Program list, select 
Other to add it. 

To add the Calculator program: 

Display the Top View menu. 

Select Programs from the Top View menu. 

Select Add a Program to Menu from the Start a 
Program menu. 

The following window appears: 



1 

2 
3 



|-St |-Add-a -Program 

Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 

BASIC Prog. Dev. Sys. Editor 
BASIC Prog. Dev. Sys. Form 
BASICA 

COBOL Compiler 
DisplayWrite 1 
DisplayWrite 2 Version 1.1 
DOS Services 
EasyWriter 1.15 

FORTRAN Compiler 1.0 Pass One 
FORTRAN Compiler 1.0 Pass Two 
FORTRAN Compiler 2.0 Pass One 
FORTRAN Compiler 2.0 Pass Two 
IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



■ 


Linker 






■ 


Macro Assembler 1.0 








Multiplan 1.1 






■ 


Pascal Compiler 1.0 


Pass 


One 




Pascal Compiler 1.0 


Pass 


Two 


■ 


Pascal Compiler 2.0 


Pass 


One 




Pascal Compiler 2.0 


Pass 


Two 


■ 


Pascal Compiler 2.0 


Pass 


Three 


■ 


PC Cluster 






■ 


FCWriter 








PeachText 








Personal Communications Mgr. 


■ 


Personal Editor 








Professional Editor 








Script/PC 






■ 


Sort 






■ 


VisiCalc 1.2 






■ 


Word Proof 






■ 


Other 







Note: This is an example of the window 
that appears on your screen. The actual 
programs listed may differ. 

4 Select Other. 



4-21 



The Calculator program is on the Top View 
Tutorial diskette. Insert the Top View Tutorial 
diskette in drive A. 

If you are using a fixed disk system and you have 
copied the Calculator to your fixed disk, type: 

d:\dir 

Where d is your fixed disk drive and dir is the 
name of the directory you have copied the 
Calculator to. 



St pAdd— a— Program- 



Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 
BA [-Program-Lacation- 
BA 
BA 
CO 
Di 
Dl 
DO 
Ea 
FO 
FO 
FO 



■ Linker 

» Macro Assembler 1.0 

• Multiplan 1.1 

■ Pascal Compiler 1.0 Pass One 



Type the path (drive and directory), if different -from below, 
where TopView can find your program(s) . 

Paths Ca:\ 3 
TopView will look for program information in the above location. 
Press <— 1 Enter 



FO 

IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



VisiCalc 1. 
Word Proof 
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Press Enter. 

TopView searches and finds the Calculator 
program information file and displays the 
following window: 



St r-Add— a— Program- 



Select a program to ADD to the Start a Program Menu. 



3101 Emulator 
Alarm Clock 
BASIC 

BASIC Compiler 
BASIC pAdd-Other- 
BASIC 
BASIC 
COBOL 
Displ 
Displ 
DOS S 
EasyW 
FORTR 



Li nker 

Macro Assembler 1.0 

Multiplan 1.1 

Pascal Compiler 1.0 Pass 



• TopView Tutorial 

• Calculator 

• Other 

** Select the programs you want to add. 
Press Button 2 when complete. 



FORTR 

FORTRAN Compiler 2.0 Pass One 
FORTRAN Compiler 2.0 Pass Two 
IBM Filing Assistant 
IBM Graphing Assistant 
IBM Reporting Assistant 
IBM Writing Assistant 



One 
Two 
One 
Two 
Three 



Mgr . 



Script/PC 
Sort 

VisiCalc 1. 
Word Proof 



Other 



Select Calculator from the list, then press Button 
2 to leave Add a Program. 



Using The Calculator Program 

After adding and starting the Calculator program, you 
can use it to do mathematical problems. To select a 
number or a function, move the pointer to the square 
containing that number or function and press Button 1 . 
You can also use the keyboard to enter numbers and 
some of the functions. The number then appears in the 
Calculator window and on the worksheet. 



For more information on the functions of this program, 
display the TopView menu in any of the Calculator 
windows and select Help. 
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Starting Programs With Top View 



On a Diskette-Based System 

1 Insert the backup copy of the program you want 
to start in drive A and close the drive door. 




L Make sure your Top View backup diskette is in 
drive B and the drive door is closed. 

3 Select the program from the Start a Program 
menu. 

Your program should now be started and be the 
foreground program. 

Top View has only enough storage to run those 
programs on the Start a Program menu whose titles are 
marked with a block. 
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Note: If Top View can't supply the ininimum 
amount of storage your program needs, plus the 
amount of storage Top View uses, the program will 
not be selectable. If your program is not selectable 
and you have started other programs, you may 
want to quit another program to free storage for 
use with your program. 

On a Fixed Disk System 

1 If your program is not on your fixed disk, or if it 
can only be run from drive A, insert the backup 
copy of your program diskette in drive A. 

2 Select the program from the Start a Program 

menu. 

Your program should now be started and be the 
foreground program. 

Top View has only enough storage to run those 
programs on the Start a Program menu whose titles are 
marked with a block. 

Note: If Top View can't supply the minimum 
amount of storage your program needs, plus the 
amount of storage Top View uses, the program will 
not be selectable. If your program is not selectable 
and you have other programs running, you may 
want to quit another program to free storage for 
use with your program. 
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Chapter 5. Additional Programs On 
Your Top View Diskette 



Contents 

DOS Services 5-3 

The Color Change Program 5-9 



5-1 



2 



Top View provides four additional programs for your 
use. DOS Services is already added to the system and 
appears on the Start a Program menu. Methods for 
adding the Alarm Clock and Calculator programs are 
explained in "Chapter 4. Starting TopView and Adding 
Your Programs." You are given instructions on how to 
add, start, and use the Alarm Clock and Calculator 
programs. You should follow the instructions for 
adding programs using the Other option on the Add a 
Program list to add the Color Change Program. Using 
the Color Change Program is explained later in this 
chapter. 



DOS Services 



Selecting DOS Services from the Start a Program menu 
allows you to perform many of the commonly used 
DOS functions without exiting TopView. When you 
select DOS Services, three windows appear on your 
display: the DOS Services Option menu, the Sort By 
menu, and the DOS Services Directory window. These 
windows are all in the foreground at the same time. 



-DOS-Services 
Copy 
Print 

■ Type 
Rename 
Erase 

■ Other 



i— Sort-By 

• Name 

• Ext 

■ Size 

■ Date/Time 



DOS-Services-Directory- 
A: \*. * 



Name 


Ext 


Size 


Dat 


s 


Ti me 


ADD 


EXT 


16384 


a 


-29 


-84 


4:25 


pm 


ATRI BUTE 


DEF 




a 


-01 


-B4 


0: 00 


am 


AUTOPIF 




369 


B 


-01 


-84 


0:00 


am 


CALC 


EXE 


56549 


8 


-24 


-84 


2:01 


pm 


CALC 


PIF 


369 


8 


-31 


-84 


9:03 


am 


CALC 


PLB 


5133 


8 


-01 


-84 


0:00 


am 


CHANGE 


EXT 


1 33 1 2 


B 


-29 


-84 


4:23 


pm 


CLOCK 


COM 


3682 


8 


-28 


-84 


2:09 


pm 


CLOCK 


PLB 


2071 


8 


-01-84 


0:00 


am 


COLORS 


EXT 


10752 


9 


-11 


-84 


5: 15 


pm 


COLORS 


PIF 


369 


8 


-01 


-84 


0: 00 


am 


COPYCHK 


COM 


142 


9 


-11 


-84 


8:52 


am 


DELETE 


EXT 


6144 


8 


-29 


-84 


4:23 


pm 


DOS 


EXT 


38912 


9 


-11 


-84 


10: 58 


am 


DOSHELP 


PLB 


1 0237 


8 


-01 


-84 


0: 00 


am 


DW1 


TBL 


51 


8 


-01 


-84 


0:00 


am 


DW2 


TBL 


51 


8 


-01 


-84 


0:00 


am 


EM 


TBL 


55 


8 


-01 


-84 


0:00 


am 


FD 


BAT 


1642 


9 


-11 


-84 


9: 19 


am 



5-3 



DOS Services Option Menu 

The DOS Services Option menu provides several 
commonly used DOS functions. They are: Copy, Print, 
Type, Rename, and Erase. These options allow you to 
execute DOS functions without having to remember the 
format of the DOS commands. For example, to rename 
a file: 

• Select the DOS Services option, Rename. 

• Then select a file from the DOS Services 
Directory. 

A window appears asking you to type the new 
filename. 

• Type the filename. 

• Press Enter. 

When you select one of the DOS Services options 
(Copy, Print, Type, Rename, or Erase), the pointer 
automatically moves to the first file displayed in the 
DOS Services Directory window. 

For more advanced users who wish to process multiple 
files in a single DOS command, you can select the DOS 
Services Other option and type the appropriate 
command with its parameters including the global 
filename characters, * and ?, in the filename or 
extension. 



DOS Services Directory Window 

The DOS Services Directory window allows you to 
display all or part of the files in a directory. The 
information provided includes the names of the files, 
the size of each file in bytes, and the date and time each 
file was created or modified. 



An "End of Directory" line marks the end of the 
directory being displayed, along with the amount of free 
space left on the disk. If the "End of Directory" marker 
is not visible, there are more entries in the directory 
than can be displayed in the window. 

You can scroll the DOS Services Directory window 
using Top View's Scroll option. To view a part of the 
directory that is not in the DOS Services Directory 
window: 

• Move the pointer into the directory window. 

• Display the Top View menu. 
Select Scroll. 

Refer to the Scroll option in "Chapter 3. About the 
TopView Program" for additional information on 
scrolling. 

Entries that name another directory are identified with 
a <DIR> in the Size field. 



Changing Directories 

To view a different directory: 

• Type the new path at the top of the directory 
window. 

• Press Enter. 

DOS Services will accept any drive, path, and file 
specifications that the DOS DIR (Directory) command 
will accept. If the current directory contains <DIR> 
entries, you can point to the directory entry and press 
Button 1 to display the files in the subdirectory. 
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DOS Services Sort By Menu 

DOS Services also provides a Sort By menu that lets 
you sort your DOS Services Directory window. The 
options allow you to sort by Name, Ext (Extension), 
Size, or Date/Time. Name and Ext sort in alphabetical 
order. Size sorts from largest to smallest. Date/Time 
sorts from most recent to oldest. 

The default is to sort the directory by Name. 



DOS Services Other Option 

When you select Other from the DOS Services Option 
menu, a window appears over the DOS Services 
Directory window with room for ten DOS commands. 
The Other option allows you to execute additional DOS 
functions not provided in the customized DOS Services 
Option menu. To execute a DOS function: 

• Type the command with the appropriate 
parameters and press Enter, 

or 

• Move the pointer to the block in front of a 
command previously entered and press Button 1 . 

If you have a diskette-based system, you need your 
DOS diskette to perform commands using the DOS 
Services Other option. Insert your DOS diskette in the 
appropriate drive when prompted to do so. 

If you re-select the Other option at any time during 
your current DOS Services session, you can select the 
commands you entered earlier. If you quit DOS 
Services, the command list is cleared. 



The commands supported by the DOS Services Other 
option are: 

COMP * 
COPY 
DATE 
DIR 

DISKCOMP * 

DISKCOPY * 

ERASE 

FIND * 

MKDIR 

PRINT 

RENAME 

SYS * 

TIME 

TREE * 

TYPE 

VER 

VOL 

To use the external commands (those marked with an 
asterisk), you will have to specify the location of these 
files before starting TopView. Do this in DOS by 
typing: 

PATH drive :\dir 

Where drive :\dir is the drive and path where your DOS 
files are located. 

The PATH command may be placed in your 
AUTOEXEC.BAT file, so that the path is 
automatically set every time you switch on your 
computer. 

Additional memory is required to execute commands 
from the DOS Services Other option. If an error 
message appears indicating that there is not enough 
memory, free some storage to successfully complete the 
requested DOS command. For additional information, 
refer to the Almost all your TopView memory is in use 
message in "Appendix A. Error Messages." 
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For information on how to use the supported 
commands, refer to your DOS manual. 



DOS Services PRINT 

The DOS Services PRINT function allows a list of files 
to be printed while running other programs under 
Top View. The number of files you can add to the print 
list depends on the amount of memory available. 

The PRINT function in the DOS Services Option menu 
allows you to add a single file to the print list each time 
you select PRINT. 

Issuing the PRINT command from the DOS Services 
Other option allows you to add multiple files to the 
print list, regardless of the directory currently displayed 
in the DOS Services Directory window. For 
information on the format of the PRINT command, 
refer to your DOS manual. 

You can use other programs or DOS Services functions 
while your files are printing. You can also Quit DOS 
Services without affecting the files that are being 
printed. 



The Color Change Program 



Add the Color Change program using the instructions 
in "Adding Programs through Other," in "Chapter 4. 
Starting Top View and Adding Your Programs." 

You can change the colors of your Top View system to 
suit your own requirements. The changes appear in 
Top View windows and Top View program windows 
which use the standard window colors. DOS programs 
are not affected. 

After you add the Color Change Program, select it from 
the Start a Program menu. The following windows 
appear: 



-Col or —Change— Program- 



Wi ndow 


Current 


Default 


Attributes 


Color 


Col or 


■ Normal 


***** 


***** 


■ Normal Highlight 


***** 


***** 


• Help 


***** 


***** 


■ Help Highlight 


***** 


***** 


■ Error 


***** 


***** 


■ Error Highlight 


***** 


***** 


■ Normal Emphasise 


***** 


***** 


■ Mark 


***** 


***** 



rProg ram— Notes 

- Button 1 selects options. 

- Eiutton 2 returns pointer. 

- SAVE saves changes on disk. 

- OUIT ends Color Change Program. 

- RESET restores de-fault colors. 



rCol or — Sel ect i ons- 
Foreground 
Colors 



Black 

Blue 

Green 

Cyan 

Red 

Magenta 

Brown 

Lt Gray 

Gray 

Lt Blue 

Lt Green 

Lt Cyan 

Lt Red 

Lt Magenta 

Yel low 

White 



Background 
Col or s 



Black 

Blue 

Green 

Cyan 

Red 

Magenta 
Brown 
Lt Gray 



Blink Of-f 
Blink On 



Current Value 
******* 
******* 
******* 



The Color Change Program window lets you choose 
which colors of the system you want to change. 

1 . Normal Text - Standard text that requires no 
special emphasis. 

2. Normal Highlight - Selected fields or other 
highlighted text. 

3. Help Text - Text presented as help or explanatory 
information. 
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4. Help Highlight - Help text that needs to be 
highlighted. 

5. Error Text - Text used in error messages or 
windows. 

6. Error Highlight - Error text that needs to be 
highlighted. 

7. Normal Emphasized - A menu or area of text that 
must be emphasized to contrast with normal text. 

8. Mark - An area of text being marked, such as the 
area being marked for a Copy operation. Mark is 
also used for all the Top View system menus (i.e., 
Window, Scissors, etc.). 

The Save, Quit, and Reset options allow you to save the 
current color values, quit while changing the color 
values for this session, or reset the values to the original 
(default) colors. 

The Color Selections window lists the foreground and 
background color choices. In most cases, the 
foreground colors represent the text and the 
background colors represent the base color of the 
window. 

Once you select a color, the Current Value area of the 
window changes to reflect the most recent color choice. 
Press Button 2 to return the pointer position to the 
Color Change Program Window. 

The Program Notes window defines Buttons 1 and 2, 
Save, Quit, and Reset. It uses normal text, so any 
changes made to the normal text colors will appear in 
this window. 
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Chapter 6. Changing Program 
Information 



Contents 



Entering Program Information 6-4 

Program Information 6-5 

Program Title 6-5 

Program Pathname 6-5 

Program Parameters 6-6 

Data Files Location 6-6 

Memory 6-7 
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Shared Program Pathname 6-11 

Shared Program Data 6-11 

Range of Software Interrupt Vectors Swapped 6-12 

Program Behavior Questions 6-12 

Writing to The Screen 6-13 

Program Accesses System Keyboard Buffer 6-13 

Foreground Only 6-14 

Math Coprocessor 6-14 
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[-Change— Program— In -for mat i on 

Program Title : CColor Change Program 

Program Pathname : [b:\colors.ext 

( 

Program Parameters : C 

( 

Data Files Location : Cb:\ 

(de-fault drive & directory) < 

Memory: C 113KB min Screen Type: C3D Window Size: [ 1] rows C 40] column? 

C 113KB max Pages: CI] Offsets : C 0] CO] 
C 163KB system 

Shared Program Pathname....: C ) 

< ] 
Shared Program Data : C ) 

< ] 

Range of Software Interrupt Vectors Swapped : C ] H low C ] H high 

Program writes directly to screen <y/n) ? Cn] 

Program accesses system keyboard buffer (y/n) ? Cn] 

Program runs only in the foreground (y/n> ? Cn] 

Program uses math coprocessor (y/n) ? Cn] 

Press Tab for next entry. Press <— 1 Enter when complete. 



This is an example of the window that appears when 
you select Change Program Information from the Start 
a Program menu and then select a program name, it 
contains all the current information Topview has on that 
program. 

Be very careful when changing the current information on 
your program. Print a copy of this window before making 
any changes. Press the Shift and PrtSc keys together to 
print the Change Program Information window. Once 
you make changes and save them, Top View forgets the 
program's original information. The updates you make 
are in effect every time you start the program again. 

Do not make changes to program information unless 
you have information about your program that differs 
from Top View's. You will most likely need to change 
the program information if you change the location of 
the program, increase the amount of memory it uses, 
change the size of its windows, or change the monitor it 
uses. Any other changes, unless you are very familiar 
with your program, could lessen its performance with 
Top View or cause it to fail to operate as intended. 
Your dealer or the program manufacturer may be able 
to supply appropriate information. 
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Entering Program Information 



To move to the various entries on the Change Program 
Information window, use the keys listed below: 



Key Function 

Tab Move to next entry 

End Move cursor to end of entry 

Shift-Tab Move to previous entry 

Ctrl-End Clear from cursor to end of entry 

Enter Form complete 



When you first see the Change Program Information 

window, the cursor appears in the program title area. If 
you do not want to change the program title, press the 
Tab key to move to the next entry. 

If you have made previous changes, tabbing to certain 
fields and typing new information does not 
automatically clear the existing information. Clear the 
previous entry before typing anything in. 

If you move the pointer to the desired entry and press 
Button 1 , the cursor appears in that position. 

You can view Change Program Information without 
changing any entries. The last program information 
window allows you to save the information you typed 
and quit, change the information again, or quit without 
saving changes. 
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Program Information 



The following sections describe the information 
expected for each entry in the Change Program 
Information window. 



Program Title 

Type a title up to 30 characters for your program. The 
title does not have to be the actual name of your 
program; it can be anything you want to call it. 

Titles are listed alphabetically in the Start a Program 
menu. 



Program Pathname 

Type the full pathname of the file that starts your 
program in the following format: 

drive: [path ] filename [. ext] 

The full pathname may be up to 62 characters. 

Change this when your program location has changed. 
For example, if you have recently copied your program 
to your fixed disk, your program's pathname might 
change from: 

a: \myprog.exe 



to 



c: \mydirect\myprog.exe 
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Program Parameters 



Type any additional items you would type next to the 
program name when you start the program. If your 
program does not use parameters, leave this blank. 

If you type a question mark, Top View prompts you for 
parameters when it starts your program. If you type 
parameters followed by a question mark, Top View 
prompts you for the remaining parameters when it 
starts your program. 

Program parameters can be filenames, numbers, or any 
type of data depending on the program. Parameter 
specifications may be up to 62 characters. 

Parameters may need to be changed or added when 
using some programs, like the language compilers. 

Note: Redirected 1/ O and piping are not 
supported. 

Data Files Location 

Type the drive and directory location of the data files 
for the program in the following format: 

drive: [path] 

This is used by Top View to locate the program's data 
files. When you add a program, these are assumed to 
be in the same location as the program. 

If your program has data files in a separate location, 
you must select Change Program Information for that 
program and type the data files location. The location 
of the data files can have a name of up to 62 characters. 
If your program has data files in the same location as 
the program itself and you change your program's 
location, you must also change your data files location. 
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The data files location is sometimes referred to as the 
"default drive and directory" setting for the program. 

Note: Top View recognizes only physically valid 
drives. For example, Top View does not recognize 
the B drive on a PC XT. 



Memory 

Type the amount of memory, in kilobytes, your 
program requires next to KB min. 

If your program runs better with more memory, type 
that amount next to KB max, if not, make KB max the 
same as KB min. 

Type the amount of system memory required by your 
program next to KB System. TopView uses this to store 
system data about your program. System data includes 
screen contents, and other data TopView keeps on 
tasks running in the system. Use the default for system 
memory of 7KB for regular DOS programs. Change 
the default to 23KB for graphics programs. 

If TopView can accommodate your program's minimum 
memory and system memory, then your program is 
selectable from the Start a Program menu. 
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Some programs are capable of using different amounts 
of memory. If you increase the amount of memory in 
your system, you may want to increase the amount of 
memory your program uses to maximize its 
performance. When you start your program, Top View 
allocates the system memory first. It then allocates 
your program's maximum memory. If the maximum is 
not available, then what is left (greater than or equal to 
the minimum) is allocated. 

Top View provides the following memory defaults: 
Minimum - 52KB 
Maximum - 52KB 



System - 7KB 



Screen Type 

If your program must run on a particular type of 
monitor, you have to change the specified screen type 
accordingly. Check to be sure you have specified the 
appropriate monitor. 

If you have a dual monitor system and one of the 
screens becomes blank when the program is started, 
you may want to change the screen type to one that is 
compatible with the monitor on which the program did 
appear. 

Enter one of the following numbers for screen type: 



0 Reserved 

1 Reserved 

2 25 X 80 Black & White 

3 25 X80 Color 

4 200 X 320 Color 

5 200 X 320 Black & White 

6 200 X 640 Black & White 

7 25 X 80 Monochrome 

D Current screen type for a DOS-based program 
X Current screen type for a Top View-based program 

D means use the screen type in effect when Top View is 
started. This is the default. 

X means use the screen type in effect when TopView is 
started. This screen type is used for new programs 
written to run in TopView only. Do not use this screen 
type with DOS programs. 
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Number of Screen Pages 



Type the number of screen pages your program uses. 
This should be a number between 1 and 8. The default 
is 1. 

Most programs use one screen page. Other programs 
take advantage of the IBM Personal Computer multiple 
screen page feature. If your program uses multiple 
screen pages, type the number of pages it uses. 

If the number of video pages specified is not sufficient, 
you may see different screens merged together. If this 
happens, increase the number of video pages for your 
program. 

Window Size 

Type the row and column dimensions of your program's 
largest window. These can be numbers between zero 
and 127. The default is the screen size, 25 rows by 80 
columns. 

Some programs are written specifically for a 25-row by 
80-column screen. These include any programs written 
in BASIC. If you have specified the window's 
dimensions to be smaller than 25 rows by 80 columns, 
and the data is not displayed correctly on the screen, 
restore the window size values to 25 rows and 80 
columns. 
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Offsets 



Type the row and column offsets from the top left 
corner of the screen at which to position your program 
window. These can be numbers between zero and 127. 
Top View provides a default of zero. 

Shared Program Pathname 

Type the full pathname of your shared program in the 
following format: 

drive :[path]filename[.ext] 

If your shared program is located in the same place as 
Top View, you need only specify the filename. If no 
drive and directory is specified, TopView first looks in 
the program's default drive and directory, then it looks 
in Top View's drive and directory. 

A shared program is one used by a number of 
programs. For example, Top View's filter program is 
used by various DOS based programs to take advantage 
of the Scissors option. 

Shared Program Data 

Type any information required by your shared program. 
If your shared program is the filter program, type the 
full pathname of your program's filter table. For 
example, 

drive ".[path Jfilenamef.extJ 

If no drive and directory is specified, TopView first 
looks in the program's default drive and directory, then 
looks in TopView's drive and directory. 
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Range of Software Interrupt Vectors Swapped 

Type hexadecimal values between 0 and FF. 

Some programs change software interrupt vectors 
because they have custom routines for handling certain 
events. If your program is one of these, enter the range 
of software interrupt vectors your program changes. If 
your program does not change software interrupt 
vectors, leave these blank. The Quit option in Top View 
is not available for programs that change software 
interrupt vectors. 

If you do not know the range of interrupt vectors 
changed by your program, you should leave the defaults 
0 to FF. Unpredictable results occur if the range 
specified is incorrect. 

Note: Programs that run under interpreted or 
compiled BASIC use the software interrupt vectors 
IB to FO. 



Program Behavior Questions 

Since the way you answer these questions affects how 
your program runs in the system, you should ask the 
program manufacturer for the correct values. 
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Writing to The Screen 



Type y or n. 

Some programs write directly to the screen (video 
buffer), rather than using DOS or other system services 
to write data to the screen. These programs must be 
suspended when they are in the background. 

If you know your program does not write directly to the 
screen, type n. This means that you can window your 
program if it allows windowing. 

The default is y to ensure that programs that do not 
supply program information will not interfere with 
other programs in TopView. 

Note: Specifying that a program does not write 
directly to the screen, when it does, can cause 
unexpected results. 

If information disappears from the screen when 
you use TopView functions, or if information from 
your program writes over text that TopView 
displays, then the program does write directly to 
the screen. You need to select Change Program 
Information and change the response to y. 



Program Accesses System Keyboard Buffer 

Type y or n. 

The system keyboard buffer is the area where 
characters typed on the keyboard are saved until they 
are processed. Programs that access the system 
keyboard buffer cannot be allowed to run in the 
background. These programs, while running in the 
background, can affect the keyboard input for the 
current foreground program. 

Answering y to this question prevents a program from 
running in the background. 
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Foreground Only 



Type y or n. 

If you are experiencing a degradation in Top View 
system performance, such as programs running slowly, 
you may want to disallow background processing on 
some of them. You can do this by answering y to this 
question. If you want your program to run in the 
background, type n. 

Some programs access the keyboard in a manner that 
causes keystrokes to be lost when these programs run in 
the background. If this happens, answer y for this 
question. 

If you do not know whether the default answers can be 
changed to n use the program with the default values. 
Answering y to any of the previous three questions 
means that your program will not run in the 
background, and will be suspended when hidden. 



Math Coprocessor 

Type y or n. 

Because of the multitasking features of Top View, a 
program that uses the math coprocessor needs special 
handling. 

If your program uses the math coprocessor, type y. 

If your Personal Computer has a math coprocessor, but 
you are not sure your program uses it, answer y to this 
question. 
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Appendix A. Error Messages 




TopView may send you a message because it doesn't 
understand something you've asked it to do. Error 
messages are displayed in windows. Press Button 2 to 
remove the error window unless otherwise instructed. 

This section contains an alphabetic list of some of the 
messages you might receive and the action to correct 
them. 
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General Error Messages 



Add a Program Error 

Cause: The title, filename or memory amount you 
gave is incorrect. You may have typed it 
incorrectly, or left the entry blank. For example, 
you may have typed in letters instead of numbers 
for the memory amount. 

Action: Press Button 2 to remove the error 
window. Then, make your correction and retry the 
operation that caused the error. 

Almost all your Top View memory is in use 

Cause: The amount of free memory needed for 
continued operation of Top View is at a very low 
level. This message warns that Top View has 
experienced difficulty satisfying a request for 
storage. If ignored, a future request for storage 
could fail. 

Action: Free system storage by ending another 
program that you no longer need. 

Although this error is only a warning, it indicates 
system failure may be imminent. Save any critical 
data to avoid loss of your most recent changes. 

Attention: Top View installation failed. 

See Top View Installation Failed. 
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Cannot find filter table file 

Cause: Top View cannot find the filter table file for 
your program. 

Action: Press Button 1 to retry. Press Button 2 to 
continue without a filter table for the program. 
Then, check whether the filter table is correctly 
specified, has the correct drive, path, and is 
correctly named in the program's information. 

Change Program Information Error 

Cause: You have typed the information 
incorrectly. Top View has highlighted the incorrect 
information. 

Action: Press Button 2 to continue. See "Chapter 
6. Changing Program Information" for instructions 
on entering program information. 

Combining files is not supported 

Cause: A DOS command was entered containing 
the DOS file append character, a plus sign. 

Action: Remove the DOS append character from 
the DOS command. 

Command Error 

x command is not supported 

Cause: You may have misspelled a DOS command 
or entered a DOS command not supported by DOS 
Services. 

Action: See DOS Services Help or DOS Services in 
"Chapter 5. Additional Programs On Your 
Top View Diskette" for a list of commands that are 
supported from the DOS Services Other option. 
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Default directory does not contain Top View. Do you 
want to continue? ( Yes or No ) 

See The default directory does not contain Top View 

Diskette in drive x: has been changed 

Cause: The diskette in the specified drive has been 
changed. 

Action: Insert the correct diskette. 

Do you want your changes saved? ( Yes or No ) 

Cause: You have selected QUIT in the Color 
Change Program without having saved your 
changes. 

Action: Select Yes or press Y to save changes in 
the system color file. Select No or press N to not 
save changes. 

DOS Device Error 

Refer to the section on device error messages later 
in this appendix. 

DOS piping is not supported 

Cause: A DOS command was entered containing 
the DOS piping character, a vertical bar. 

Action: Remove the vertical bar (DOS piping 
character) and the chained commands from the 
DOS command. 



Error processing DOS Services help window 

Cause: The file DOSHELP.PLB could not be 
found. 

Action: On a fixed disk system, ensure the file 
DOSHELP.PLB is in the default drive and 
directory specified in the program information for 
DOS Services. On a diskette-based system, place 
the Top View diskette in the appropriate drive and 
press Button 1 to retry DOS Services Help. 

File resources used up 

Cause: You are already accessing the maximum 
number of files DOS allows (20). 

Action: Press Button 2 to remove the error 
window and cancel the request. Then end an 
application that is using one or more file handles 
and retry the operation. You may want to increase 
the number specified in the files command of your 
CONFIG.SYS file, if you are not already using the 
maximum. 

File to print is not available 

See The file to print is not available 

Internal Top View error occurred 

Cause: An internal Top View error occurred. 

Action: Press Button 2 to remove the error 
window and return to DOS. 
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1/ O error trying to load program 

Cause: A DOS error occurred while trying to load 
your program. 

Action: Press Button 2 to remove the error 
window. Try to start the program again. 

Missing Tutorial Panel File 

Cause: The Tutorial diskette was copied to a disk 
improperly. If you installed the Tutorial as a 
program, you may have specified the wrong data 
files location. 

Action: Make sure you have specified the correct 
data files location. If your Tutorial diskette is 
defective, copy the Tutorial again. Press Enter to 
retry or Q to Quit. 

Not enough memory to complete loading this program 

Cause: There is not enough memory in your 
system to load the program requested. This 
message appears when an unexpected use of 
memory occurs after the program was marked 
selectable in the Start a Program menu. 

Action: Free system storage by ending another 
program that you no longer need. You can also 
use Change Program Information to specify a lower 
minimum storage for your program if possible. 
Press Button 2 to remove the error window. 



Not enough memory to continue 

Cause: There is not enough free memory to 
continue the present operation. You may have too 
many programs running for the operation you are 
trying to do. 

Action: Free memory by ending a program you no 
longer need. Be sure to save any necessary files. 
Press Button 1 to retry the operation. 

Not enough memory to continue, Program Terminated 

Cause: There is not enough free memory to 
continue the present operation or to present the 
previous message allowing a retry. When this 
message is issued, the program named in the 
window title has been forcibly terminated by the 
system. 

Action: Free memory by ending a program. Then, 
retry the operation. Press Button 2 to remove the 
error window. 

Not enough memory to load the filter table file 

Cause: There is not enough memory in your 
system to load the filter table for the program. 

Action: Free memory by ending a program you no 
longer need. Be sure to save any necessary files. 
Press Button 1 to retry loading the filter table. 
Press Button 2 to continue without a filter for the 
program. 
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Not enough space on disk for this file 

Cause: There is not enough space on your disk to 
save this file. 

Action: Save the file on another disk or erase 
unwanted files from the disk you have named. 
Press Button 2 to remove the error window. Retry 
the operation that failed. 

Printer is not ready 

Cause: You have specified a file to be printed, but 
the printer is not turned on, not on-line, or out of 
paper. 

Action: Make sure the printer is turned on, is 
on-line, and is not out of paper. Press Button 2 to 
remove the error window. If you do not correct 
the problem with the printer, the file or files will be 
added to the print list, but will not print until the 
printer is ready. 

Program diskette not in drive 

Cause: The program you are trying to start is not 
in the indicated drive. 

Action: Remove the diskette which is currently in 
the drive and insert the correct program diskette. 
Then, press Button 1 to retry the load operation. 
If you decide you don't want to start the program, 
press Button 2 to cancel this request. 



Program Information File Error 

Cause: You may not have Top View in your 
default drive and directory. This error is also 
displayed if any DOS I/O error occurs while trying 
to access the Program Information File. This could 
mean that the Program Information File is located 
on a bad spot on your disk. It can also occur if you 
replace your .PIF or .PII file with another one that 
does not have the correct format. 

Action: Make sure that Top View is in your default 
drive and directory. Press Button 2 to remove the 
error window and cancel the request. 

Program Information Index File Sort Error 

Cause: Top View cannot sort the Program 
Information Index File. You may have a defective 
diskette. 

Action: Recopy the original TopView diskette you 
received. 
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Program not found 



Cause: 1. Top View cannot find the program you 
want to start. 2. Top View cannot find the file 
needed to execute the command you have specified 
within DOS Services. 

Action: If you were using DOS Services when you 
received the error, exit Top View. Establish a path 
to the location on your disk where the DOS files 
(for example, DISKCOPY.COM) are found. 
Refer to "Chapter 5. Additional Programs On 
Your Top View Diskette," for information on how 
to specify the location of your DOS command files. 

Otherwise, insert the program diskette or, if you 
have a fixed disk, ensure that the program location 
given in the Program Information File is correct. 
Press Button 2 to remove the error window, then 
use Change Program Information to correct the 
program pathname entry. 

Program too large for program area specified 

Cause: The minimum or maximum memory you 
have specified for the program is not large enough 
to hold the program. 

Action: Consult your program documentation to 
determine the amount of memory the program 
requires. Change the Program Information File and 
give a larger number for minimum/ maximum 
memory. 

Redirecting DOS input and output is not supported 

Cause: A DOS command was entered containing 
the DOS input or output redirection characters, a 
greater than (>), or less than (<) sign. 

Action: Remove the DOS input or output 
redirection character from the DOS command. 
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Setup system file error 

Cause: You may not have Top View in the default 
drive and directory. This error can also occur if 
the TopView diskette is bad or if Top View is 
located on a bad spot on your disk. 

Action: First, make sure that TopView is in the 
default drive and directory. Press any key to 
return to DOS, then retry Setup. 

If the error occurs again, make a new copy of your 
TopView diskette, or recopy the TopView files to 
your disk. If the error still occurs, consult your 
dealer. 

Shared program diskette not in drive 

Cause: The program you are trying to start needs a 
shared program, not found on the diskette in the 
drive indicated. 

Action: Remove the diskette currently in the drive 
and insert the diskette that contains the shared 
program. For the IBM-supplied shared program, 
FILTER.EXT, insert your TopView backup 
diskette. Then, press Button 1 to retry the shared 
program load or Button 2 to continue. 

Shared Program not found 

Cause: The shared program pathname in the 
Change Program Information menu is incorrect. 

Action: Make sure that the program location in 
Change Program Information is correct. Press 
Button 2 to remove the error window. 

System memory specified for X is insufficient 

See The system memory specified for X is 
insufficient 
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"Terminate and Remain Resident" function is not 
supported 

See The "Terminate and Remain Resident" function 
is not supported 

The default directory does not contain TopView. Do you 
want to continue? ( Yes or No ) 

Cause: The Color Change Program was unable to 
find TopView in its default directory when you 
selected the Save option. Since the color file is 
loaded by TopView, it should normally be stored in 
the TopView directory. This warning condition 
could occur if you have a diskette-based system 
and the TopView diskette is not in the default 
drive or the Color Change Program default 
directory entry is incorrect. 

Action: Insert the correct diskette, if appropriate. 
Select Yes or press Y if you want to save the color 
file. Select No or press N if you want to cancel the 
Save option. If the default directory entry is 
incorrect, you must first quit the Color Change 
Program. Correct the entry using Change Program 
Information, restart the Color Change Program and 
select the Save option again. 

The file to print is not available 

Cause: A file that was added to the print list was 
not available at the time the file was to be printed. 
This can occur if the file on the print list has been 
erased, is being used by another program, or if the 
diskette on which the file resides has been 
removed. 

Action: When you select a file to print, make sure 
the file remains available until it has completed 
printing. 



The system memory specified for X is insufficient 



Cause: The amount of memory needed for system 
storage is larger than that indicated in the Program 
Information File for this program. 

If you continue with this program, some future 
request for storage may fail, possibly leading to 
loss of data. 

Action: Press Button 2 to remove the error 
window. Use Change Program Information to 
increase the value specified for "System" memory, 
then rerun the program. Refer to "User Options," 
"Appendix B. Things to Know" for more 
information. 

The "Terminate and Remain Resident" function is not 
supported 

Cause: The current program has issued a DOS 
request (INT 27H or INT 21H, AH = 31H) to end 
but remain resident in storage. This function is not 
supported in Top View. 

Action: You should not use this program with 
TopView. Press Button 2 to remove the error 
window. 

There is insufficient memory to hold the entire directory 

Cause: DOS Services does not have enough 
memory to read in all the entries for the specified 
directory. 

Action: Increase the amount of memory for DOS 
Services in the Program Information File. Refer to 
"Chapter 6. Changing Program Information" for 
more information on increasing the amount of 
memory. 
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Top View installation failed. All files from your Top View 
diskette were not copied. 



Cause: There is not enough room on your fixed 
disk to install Top View, or there may be bad 
sectors on the diskette. 

Action: Erase some files from your fixed disk and 
try the installation procedure again. If the diskette 
is bad, see your dealer. 

Unable to access default drive or directory 

Cause: The drive or directory you named as the 
default when you added your program, or on the 
Run-time Parameters window, cannot be accessed. 

Action: Press Button 1 to correct the entry before 
continuing to your program. Press Button 2 to 
continue without changing the entry. You should use 
Change Program Information to correct the entry 
before you run this program again. 

Unable to update color file 

Cause: A DOS I/O error occurred when you 
selected the Save option in the Color Change 
Program. This could occur if you are using a 
write-protected diskette or there is not enough 
space on disk for ATRIBUTE.DEF, the 32-byte 
system color file. 

Action: Press Button 2 to remove the error 
window and cancel the request. Correct the error 
condition and retry the Save option. 

WARNING: Almost all your Top View memory is in use. 

See Almost all your Top View memory is in use 



Wrong Video Mode 

Cause: The Color Change Program requires video 
mode 3. 

Action: Press Button 2 to terminate the Color 
Change Program. Use Change Program 
Information to change the screen type to 3. 

You can run only one internal DOS command at a time 

Cause: You tried to run more than one internal 
DOS command from the DOS Services Other 
option at the same time. 

Action: End the first internal command, and retry 
the second internal command. Refer to your DOS 
manual for additional information on DOS internal 
and external commands. 



Device Error Messages 

When you are using a DOS function, you may receive a 
DOS message. 

Each message appears in this format: 

DOS Device Error 
Reading Drive X 
(error message) 
Press Button 1 to Retry 
Press Button 2 to Quit 

or 

DOS Device Error 
Accessing Device XXXXX 
Press Button 1 to Retry 
Press Button 2 to Quit 
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Note: Due to inconsistencies between DOS and 
some programs, pressing Button 1 or 2 might cause 
you to get the same error message again without 
any action taking place. If this happens, Quit the 
program and start over. 

Listed below are some of the DOS device error 
messages. The corrective action on all of these is as 
follows, except where indicated. 

Press Button 1 to retry or Button 2 to quit. 
Both actions remove the error window. 

For more information on any of these error messages, 
consult your DOS manual. 

Bad FAT memory image 

Cause: The DOS File Allocation Table in memory 
is bad. Further processing is probably impossible. 

Bad request structure length 

Cause: A device driver received an incorrect length 
request header. 

Data error (CRC) 

Cause: The disk Top View is reading/ writing has a 
data error. 

Action: If writing, use a different diskette. If 
reading, the file is probably unrecoverable. The 
disk may have a bad sector. 

Device not ready 

Cause: The drive named is not ready. The drive 
door may not be closed or the diskette is not in the 
drive. 
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General failure 

Cause: An internal DOS error occurred. 

Printer out of paper 

Cause: The printer is out of paper or is not turned 
on. 

Action: Add more paper or power on the printer. 
Read fault 

Cause: DOS could not successfully read the data. 

Sector not found 

Cause: The sector containing the data could not be 
located. This usually means there is a defective 
spot on the disk. 

Seek error 

Cause: The proper track on the disk could not be 
found. 

Unknown command 

Cause: A device driver issued an invalid 
command. 

Unknown media type 

Cause: You are using a disk that is incompatible 
with your drive. 
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Unknown unit 



Cause: A device driver received an invalid 
sub-unit number. 

Write fault 

Cause: DOS could not successfully write the data 
to the disk. 

Write-Protected Diskette 

Cause: The diskette you are attempting to write to 
is write-protected. 

Action: Use a non-write-protected diskette or 
remove the write-protect tab to write to the 
diskette. Remove the tab ONLY if you are sure 
you want to write on the diskette in the drive. 



Appendix B. Things to Know 



Using A Mouse 

• When using both a serial mouse and a modem, you 
will need two asynchronous communication ports 
in your system. See your installation instructions 
for installing a second or alternate asynchronous 
communication port. Refer to the communication 
program's documentation to find out which one of 
the serial ports is specifically required for modem 
use. 

If you have to move the mouse from one serial port 
to the other, you must run the TopView Setup 
procedure again. 

• If you have two asynchronous communications 
ports, you should attach the the serial mouse to the 
alternate port. 
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Microsoft Mouse Installation (model number 
037-099). 

This mouse connects to the IBM Personal 
Computer, IBM Personal Computer XT, an IBM 
Portable Personal Computer, an IBM 3270 
Personal Computer, or an IBM Personal Computer 
AT through a printed circuit board supplied with the 
mouse. The board is installed in an I/O expansion 
slot in your Personal Computer. A small connector, 
or "jumper," is located on the mouse printed circuit 
board. The jumper consists of four sets of pins with 
a moveable piece that forms a connection between 
one of the pairs: 



You can change the jumper setting by moving the 
connecting piece from one pair of pins to another. 
How you set the jumper, depends on the other 
devices you have in your system. The following 
suggestions will help you avoid setting the jumper 
in a manner which would conflict with another 
device in your system. 

- If you have an IBM Personal Computer XT, 
IBM 3270 Personal Computer, or an IBM 
Personal Computer with fixed disk(s) in an 
expansion unit, do not set the jumper to five. 

- If you have an IBM Personal Computer AT, 
do not set the jumper to 2. 




- If you have an Asynchronous 
Communications Adapter or a Binary 
Synchronous Communications Adapter 
configured as the primary adapter, do not set 
the jumper to four. 

- If you have an Asynchronous 
Communications Adapter or a Binary 
Synchronous Communications Adapter 
configured as the secondary adapter, do not 
set the jumper to three. 

- If you have a Synchronous Data Link Control 
Communications Adapter, do not set the 
jumper to either three or four. 

If you have an IBM 3270 Personal Computer 
do not set the jumper to two. 
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Memory Management 



• When Top View starts your programs, it uses the 
first free area of memory it finds that is large 
enough for your program. If you have several 
programs you want to start, you should start the 
most important programs first, to ensure that they 
are given the memory they need. 

• When you end a program, an area of memory 
becomes open for use. If you know you will be 
ending two or more programs early in your use of 
the system, start them one right after the other. 
Ending two programs started consecutively may 
free up one large area of memory. 

• A larger amount of memory than the minimum 
memory amount (256KB) is necessary to execute 
several large programs at the same time, programs 
with several windows , or to copy a large block of 
text using the Scissors option. 

• When you add a program through Other without 
program information available, Top View asks you 
how much memory your program needs. It then 
uses that amount for both the minimum and 
maximum memory settings in the Program 
Information File. For some programs, you may 
want to increase the maximum amount so that your 
program can have more memory, if it is available, 
to maximize its performance. 
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• Some spreadsheet programs, like IBM's 
Multiplan™ 1 and VisiCalc® , 2 have been assigned 
minimum amounts of memory. You might want to 
change the program information on the maximum 
amount of memory you want your program to have 
so you can create large spreadsheet models. 

• If you try to start a program and the program does 
not load, or is not behaving as expected, you might 
not have allocated enough memory to your 
program. Increase the program's memory 
requirements. 



Multiplan is a trademark of Microsoft Corporation. 
VisiCalc is a registered trademark of VisiCorp. 
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Running Programs 



• Batch files are not supported. 



Some programs do not allow two copies of 
themselves to be in the Top View system at the same 
time. When one copy of the program has left a file 
open, which the second copy tries to access, an 
error occurs. Programs that cannot be multiply used 
include VisiCalc, Professional Editor, and the 
language compilers version 1.00. 

Note: Multiple copies of these programs can 
run in the TopView system at the same time if 
you specify each program separately, using 
different directories for each copy of the 
program. 

When using a communications program with 
TopView, start the communications program 
before starting other programs. 

For programs which open and access files on the 
diskette, unless the program itself requests a 
change of diskettes, you should not remove the 
diskette from the drive. 



• TopView recognizes only physically valid drives. 
For example, TopView does not recognize the B 
drive on a PC XT. 

• The SHELL command in BASICA is not 
supported with DOS version 3.00. 

• If you have a program that demands a lot of 
processing, like a language compiler running in the 
background, it could slow down the response time 
in your other programs. 

• If you try running a program under TopView and 
get unexpected results you should: 
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- Verify that the program is working as 
expected outside Top View, in the standard 
DOS environment. 

- Check that the memory amount specified in 
your Program Information File is enough to 
run your program. If you are experiencing 
problems, it is sometimes a good idea to try 
the program under Top View with more 
memory than appears to be necessary. 

• When printing a non-graphics file from a program 
other than DOS Services, system performance may 
be improved if you write the data into a disk file 
and use DOS Services to print the file. 

• If you are using a diskette-based system, it is 
possible to have two separate programs opening a 
file on the same diskette. You should keep data 
diskettes in separate drives or take care in 
swapping diskettes. 

• If you use the ASSIGN command from DOS 
before starting TopView, remember that it will 
affect all the programs running in the system. 
Using ASSIGN is not recommended. 
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File Lock-Out Mechanism 



The file lock-out mechanism protects files from being 
accessed by multiple tasks at the same time. Once a 
program opens a file for write access, other programs 
are "locked out" from accessing that file until the file is 
closed by the original program. If this occurs, you will 
receive a file not found message. 

Some programs open temporary files. If two copies of 
these types of programs are running, a "disk full" or 
"file creation" error may occur in one of the copies. 
You will not be able to run two copies of these 
programs in the same subdirectory. 

Programs written in compiled BASIC or COBOL use a 
"runtime" program file. If two programs try to access 
the same runtime file, the lock-out mechanism will be 
invoked. You may want to move these files to separate 
subdirectories. 



Using the Printer 

• If your program runs only in the foreground, 
printing is suspended when you press Button 3. 
Printing resumes when you press Button 3 again. 

• The printer can only be used by one program at a 
time. If the printer is being used by one program, 
and another program tries to use it, a message will 
be displayed by Top View. You may then either 
allow the program using the printer to continue to 
use the printer, or allow the new program to use it. 

• When the printer is "reassigned" (the second 
program owns the printer), a form feed will be sent 
to the printer to assure that the paper is lined up 
for the new owner. A form feed is also sent to the 
printer when a program which used the printer is 
ended. 
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• When trying to print, if both the program and 
Top View end up in error states, respond to the 
program error prompt first, and then to TopView's 
error. 

• Redirection of the printer to a communication port 
using the MODE command is not supported. 

• Serial printers are not supported. 

User Options 

Top View provides a shortcut to specify certain options. 
For example, you can tell Top View what monitor to use 
by using option codes. The option codes are single 
characters preceded by a slash that tell Top View how 
you want your system to run. Any number of codes 
can follow the slash, and they can be specified in any 
order. If there are two conflicting codes, the last code 
specified is used. If an option code is not specified, 
Top View assumes the default for that option. 

For example, if you want to start TopView on a color 
monitor, and allow Exit from TopView at any time, you 
would type: 

9 /ce 

from the TopView directory, or 

topview /ce 

from the root directory. The option codes and their 
meanings are : 

D = Start TopView on the current display (this is 
the default). 

M = Start TopView in 80x25 text mode on a 
monochrome display. 

C = Start TopView in 80x25 text mode on a color 
display. 
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G = Start Top View in high resolution graphics 
(640x200) mode. 

B = The monitor attached to the color display 
adapter is a monochrome (i.e. black and white) 
display, and cannot display color. 

O = Run Top View only on the display it is started 
on. This option is only useful for systems with two 
display adapters. It allows the user to restrict 
Top View to running on only one of the two 
displays. Top View would normally attempt to use 
both displays if possible. 

R = The pointing device is set up for right-handed 
use (this is the default). 

L = The pointing device is set up for left-handed 
use. 



1 = The pointing device is connected to the 
primary Asynchronous Communications Adapter 
(this is the default). 

2 = The pointing device is connected to the 
alternate Asynchronous Communications Adapter. 

To use the option codes above, (R, L, 1, and 2), you 
must have gone through the TopView Setup procedure 
in Chapter 2. 

E = Allows Exit from TopView back to DOS at 
any time. This option lets you exit TopView 
without having to quit all your programs. This is 
useful if you are running a program that doesn't 
allow the TopView Quit feature. Make sure you 
save any necessary files before exiting TopView. 
The default is to allow Exit only when there are no 
programs running. 



S= Stops the following warning message from 
being displayed whenever any program exceeds the 
amount of system memory specified in its program 
information file. 

The system memory specified for this program 
is insufficient. 

This tells you that you may need to change the 
system memory amount for your program in the 
Change Program Information window. 

F = Does not allow disk output to be buffered. 
Specifying this option forces all disk output to 
occur at the time a program makes a write request. 
The default is to buffer write requests. Using this 
option may slow the performance of programs that 
write to disk. However, it reduces the possibility 
of errors caused by removing a diskette containing 
open output files during program use. You should 
specify this option with programs that update files 
on diskette rather than on fixed disk. 

+ = Increases the speed of the pointer. 

- = Decreases the speed of the pointer. Use the - 
option with high resolution graphics programs for 
more precise pointer movement. 

A = Allows you to bypass the Welcome window. 
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Appendix C. Copying Top View 



Copying Top View with a Diskette-Based 
System 



This section applies to diskette-based systems 
only. To copy Top View to a fixed disk, refer 
to "Installing Top View On Your Fixed Disk," later in 
this appendix. 
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Follow the steps below to copy Top View. 

1 Label a blank formatted diskette "Top View 
Backup." 

2 Insert the DOS diskette into drive A and close 
the drive door. 




*j Switch your computer on. If it is already on, 

press the Ctrl, Alt, and Del keys (System Reset). 

When prompted: 

4 Type the date and press Enter. 

5 Type the time and press Enter. 

6 At the DOS prompt, A>, type: 
diskcopy a: b: 

and press Enter. 



Note: When the screen message tells you to 
insert the source diskette in drive A, you 
must insert your TopView program diskette 
in drive A. When the screen message tells 
you to insert your target diskette in drive B, 
insert the diskette you labeled "TopView 
Backup" in drive B. 

T After the Copy Complete message, press si. 

8 Remove your original TopView program diskette 
from drive A, store it in a safe place and use 
your TopView backup diskette for your 
everyday work. 

Go to "Chapter 2. Getting Started" to run Setup and 
start the Tutorial. 
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Installing Top View On Your Fixed Disk 



This section applies to fixed disk systems only. 
If you have a diskette-based system, refer to 
"Copying Top View with a Diskette-Based System," 
earlier in this appendix. 



The instructions in this section show you how to copy 
Top View to a directory named "Top View" that 
TopView creates for you. 

You must install TopView from drive A. To install 
TopView using a different diskette drive, reassign that 
drive to drive A. 



1 



Switch your computer on. If it is already on, 
press the Ctrl, Alt, and Del keys (System Reset). 



When prompted: 



2 



Type the date and press Enter. 



3 



Type the time and press Enter. 
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4 



Insert the Top View program diskette in drive A 
and close the drive door. 




To set your current drive and directory to the 
root directory type: 

d: 



and press Enter. 



Note: When using a fixed disk system, you 
can specify which drive you want to install 
Top View on. The d parameter denotes any 
fixed disk drive you want to install Top View 
on. 



Now, type: 

cd\ 

and press Enter. 
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7 



At the DOS prompt, type: 



a:fd 

and press Enter. 

You will see a message telling you Top View is 
creating a subdirectory for you on your fixed 
disk and copying the files from the Top View 
diskette to the new subdirectory. 

8 When the files have been copied you will see a 
message instructing you to begin Setup. Before 
you begin Setup, remove the original Top View 
program diskette from drive A and put it in a 
safe place. 

If you want to recopy Top View to a fixed disk, follow 
the steps above. This procedure will save your old 
program information files (TV.PII and TV.PIF) so that 
you will not need to add your programs again. 

Notes: 

1 . You can copy the Calculator program to your 
fixed disk, if you would like. Then you can add 
it to the Start a Program menu and run it from 
there. 

2. To copy the Calculator to your fixed disk, type 
the following: 

copy a:calc* d:\dir 

Where d: \ dir is the drive and directory of your 
choice and the tutorial diskette is in drive A. 

Go to "Chapter 2. Getting Started" to run Setup and 
start the Tutorial. 



Copying Top View Using DOS 3.00 



This section applies to copying Top View to 
a diskette using an IBM Personal Computer 
AT with DOS 3.00. To copy Top View to a fixed 
disk, refer to "Installing Top View On 
Your Fixed Disk" earlier in this appendix. 



If you have an IBM Personal Computer AT and drive B 
is a 3 20/3 60KB drive, you should copy Top View to a 
320/360KB diskette. Because some programs can be 
started from only drive A, we give you instructions so 
that Top View can be run from drive B. 

If both diskette drives in your system are 1.2MB 
diskette drives, you can copy TopView to a 1.2MB 
diskette. We do not recommend that you set up 
TopView in a subdirectory on a 1.2MB diskette. 

You must install TopView from drive A. To install 
TopView using a different diskette drive, reassign that 
drive to drive A. 

Follow the steps below to copy TopView to a 1 .2MB or 
360KB diskette. 

1 Label a blank formatted diskette "TopView 
Backup." 

2 Insert the DOS 3.00 diskette into drive A and 
close the drive door. 
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Switch your computer on. If it is already on, 
press the Ctrl, Alt, and Del keys (System Reset). 

When prompted: 

Type the date and press Enter. 

Type the time and press Enter. 

Remove the DOS 3.00 diskette from drive A. 



Insert the original Top View program diskette in 
drive A. 



Insert the TopView backup diskette in drive B. 

At the DOS prompt, A>, type: 

Copy a:*'.* b: 

10 Press Enter. 

11 Before you begin Setup, remove the original 
TopView program diskette from drive A and put 
it in a safe place. 

Notes: 

1 . TopView supports DOS versions 2.00 and 2.10 
functions. 

2. You can copy the Calculator program to your fixed 
disk, if you would like. See note on page C-6 for 
instructions. 

Go to "Chapter 2. Getting Started" to run Setup and 
start the Tutorial. 
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